APISIX-MCP
๐๏ธ ๐ ๐ MCP Server that support for querying and managing all resource in [Apache APISIX](https://github.com/apache/apisix).
What is APISIX-MCP?
APISIX-MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐๏ธ ๐ ๐ mcp server that support for querying and managing all resource in [apache apisix](https://github.com/apache/apisix).
๐๏ธ ๐ ๐ MCP Server that support for querying and managing all resource in [Apache APISIX](https://github.com/apache/apisix).
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ๐๏ธ ๐ ๐ MCP Server that support for querying and managing all
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx apisix-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use APISIX-MCP
APISIX MCP is a TypeScript-based Model Context Protocol server that exposes the full Apache APISIX Admin API to AI assistants, enabling natural-language management of routes, upstreams, services, SSL certificates, plugins, consumers, secrets, and stream routes. Platform engineers and DevOps teams use it to query gateway configuration, troubleshoot routing issues, and make configuration changes to their APISIX instance through conversational AI without needing to remember the exact Admin API endpoints and JSON schemas.
Prerequisites
- A running Apache APISIX instance (v3.x recommended) with the Admin API accessible
- The APISIX Admin API key (default: edd1c9f034335f136f87ad84b625c8f1, but you should set a custom one in production)
- Node.js 18+ and npx available in PATH
- An MCP-compatible client such as Claude Desktop
Confirm APISIX Admin API is accessible
Before configuring the MCP server, verify you can reach the APISIX Admin API from the machine where Claude Desktop runs. The default port is 9180.
curl http://127.0.0.1:9180/apisix/admin/routes \
-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1'Add the MCP server to Claude Desktop config
Edit claude_desktop_config.json to add the apisix-mcp entry. Set APISIX_SERVER_HOST, APISIX_ADMIN_API_PORT, and APISIX_ADMIN_KEY to match your APISIX deployment.
{
"mcpServers": {
"apisix-mcp": {
"command": "npx",
"args": ["-y", "apisix-mcp"],
"env": {
"APISIX_SERVER_HOST": "http://127.0.0.1",
"APISIX_SERVER_PORT": "9080",
"APISIX_ADMIN_API_PORT": "9180",
"APISIX_ADMIN_API_PREFIX": "/apisix/admin",
"APISIX_ADMIN_KEY": "your_admin_api_key"
}
}
}
}Alternatively install via Smithery
Smithery can install and configure the APISIX MCP server automatically for Claude Desktop without manual JSON editing.
npx -y @smithery/cli install @api7/apisix-mcp --client claudeRestart Claude Desktop
Quit and reopen Claude Desktop so it connects to the APISIX MCP server on startup. You should see the apisix-mcp tools available in the tool list.
List current routes to verify connectivity
Ask Claude to list all configured routes in your APISIX instance as a smoke test to confirm the server can reach the Admin API.
APISIX-MCP Examples
Client configuration
Full claude_desktop_config.json entry for APISIX MCP with all five environment variables that control connectivity to your APISIX Admin API.
{
"mcpServers": {
"apisix-mcp": {
"command": "npx",
"args": ["-y", "apisix-mcp"],
"env": {
"APISIX_SERVER_HOST": "http://127.0.0.1",
"APISIX_SERVER_PORT": "9080",
"APISIX_ADMIN_API_PORT": "9180",
"APISIX_ADMIN_API_PREFIX": "/apisix/admin",
"APISIX_ADMIN_KEY": "your_admin_api_key_here"
}
}
}
}Prompts to try
Example prompts for querying and managing Apache APISIX resources through natural language.
- "List all routes configured in APISIX"
- "Show me the details for the upstream with ID 1"
- "Create a new route that forwards /api/v1/* to upstream http://backend:8080"
- "What plugins are enabled globally in APISIX?"
- "List all SSL certificates and show their expiration dates"
- "Send a test request to the APISIX gateway at /health and show the response"Troubleshooting APISIX-MCP
All Admin API calls return 401 Unauthorized
The APISIX_ADMIN_KEY must match the key configured in your apisix.yaml (under deployment.admin.admin_key). Check the key value with: grep admin_key /path/to/apisix/conf/config.yaml. In production, always change the default key.
Server cannot reach APISIX Admin API (connection refused)
Set APISIX_SERVER_HOST to the actual hostname or IP where APISIX is running. If APISIX runs in Docker, use the container's IP or the host's IP (not 127.0.0.1) from the Claude Desktop process perspective. You can also use a hostname like http://apisix if using Docker Compose networking.
Route creation succeeds but traffic still returns 404
Verify the route is targeting requests through port APISIX_SERVER_PORT (default 9080), not the Admin API port (9180). Send a test request to port 9080 to verify gateway traffic routing is working.
Frequently Asked Questions about APISIX-MCP
What is APISIX-MCP?
APISIX-MCP is a Model Context Protocol (MCP) server that ๐๏ธ ๐ ๐ mcp server that support for querying and managing all resource in [apache apisix](https://github.com/apache/apisix). It connects AI assistants to external tools and data sources through a standardized interface.
How do I install APISIX-MCP?
Follow the installation instructions on the APISIX-MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with APISIX-MCP?
APISIX-MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is APISIX-MCP free to use?
Yes, APISIX-MCP is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
APISIX-MCP Alternatives โ Similar Cloud Services Servers
Looking for alternatives to APISIX-MCP? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
โ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
โ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
โ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
โ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
โ 26.7kๆฌ้กน็ฎไธบxiaozhi-esp32ๆไพๅ็ซฏๆๅก๏ผๅธฎๅฉๆจๅฟซ้ๆญๅปบESP32่ฎพๅคๆงๅถๆๅกๅจใBackend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
โ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up APISIX-MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use APISIX-MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.