{"id":26775473,"url":"https://github.com/api7/apisix-mcp","last_synced_at":"2026-08-27T15:44:29.709Z","repository":{"id":284895193,"uuid":"955762830","full_name":"api7/apisix-mcp","owner":"api7","description":"APISIX Model Context Protocol (MCP) server is used to bridge large language models (LLMs) with the APISIX Admin API.","archived":false,"fork":false,"pushed_at":"2025-06-16T07:53:11.000Z","size":89,"stargazers_count":38,"open_issues_count":2,"forks_count":17,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-08-12T14:41:52.212Z","etag":null,"topics":["api-management","apisix","mcp","mcp-server","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/api7.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-27T06:46:33.000Z","updated_at":"2026-07-06T10:51:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"a5bba103-2350-4696-bce4-e55ecf1e52c4","html_url":"https://github.com/api7/apisix-mcp","commit_stats":null,"previous_names":["api7/apisix-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/api7/apisix-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api7%2Fapisix-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api7%2Fapisix-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api7%2Fapisix-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api7%2Fapisix-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/api7","download_url":"https://codeload.github.com/api7/apisix-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api7%2Fapisix-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36944061,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-22T15:14:58.755Z","status":"online","status_checked_at":"2026-08-27T02:00:07.166Z","response_time":96,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-management","apisix","mcp","mcp-server","typescript"],"created_at":"2025-03-29T03:18:27.852Z","updated_at":"2026-08-27T15:44:29.696Z","avatar_url":"https://github.com/api7.png","language":"TypeScript","funding_links":[],"categories":["Cloud \u0026 Infrastructure","API Integration MCP Servers","サーバー実装","📚 Projects (1974 total)","Community Servers","Cloud Platforms","カテゴリ","🛠️ DevOps Tooling","🌐 Web Development","MCP Servers \u0026 Protocol","💻 Developer Tools (164 servers)","Server Implementations","Table of Contents"],"sub_categories":["Cloud Platforms","🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発者ツール","MCP Servers","How to Submit","☁️ \u003ca name=\"cloud--infrastructure\"\u003e\u003c/a\u003eクラウド・インフラ","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eDeveloper Tools","AI Services"],"readme":"[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/api7-apisix-mcp-badge.png)](https://mseep.ai/app/api7-apisix-mcp)\n\n# APISIX Model Context Protocol (MCP) Server\n[![smithery badge](https://smithery.ai/badge/@api7/apisix-mcp)](https://smithery.ai/server/@api7/apisix-mcp)\n\nAPISIX Model Context Protocol (MCP) server is used to bridge large language models (LLMs) with the APISIX Admin API. It aims to enable natural language-based interaction for viewing and managing resources in APISIX through MCP-compatible AI clients.\n\nhttps://github.com/user-attachments/assets/081e878c-225e-4ff8-a9c5-5813f4784cfe\n\n## Support Operations\n\n### Common Operations\n\n- `get_resource`: Retrieve resources by type (routes, services, upstreams, etc.)\n- `delete_resource`: Remove resources by ID\n- `send_request_to_gateway`: Send a request or multiple requests to the APISIX gateway\n\n### API Resources Operations\n\n- `create_route`/`update_route`/`delete_route`: Manage routes\n- `create_service`/`update_service`/`delete_service`: Manage services\n- `create_upstream`/`update_upstream`/`delete_upstream`: Manage upstream\n- `create_ssl`/`update_ssl`/`delete_ssl`: Manage SSL certificates\n- `create_or_update_proto`: Manage protobuf definitions\n- `create_or_update_stream_route`: Manage stream routes\n\n### Plugin Operations\n\n- `get_all_plugin_names`: Get all available plugin names\n- `get_plugin_info`/`get_plugins_by_type`/`get_plugin_schema`: Retrieve plugins configuration\n- `create_plugin_config`/`update_plugin_config`: Manage plugin configurations\n- `create_global_rule`/`update_global_rule`: Manage plugin global rules\n- `get_plugin_metadata`/`create_or_update_plugin_metadata`/`delete_plugin_metadata`: Manage plugin metadata\n\n### Security Configuration\n\n- `get_secret_by_id`/`create_secret`/`update_secret`: Manage secrets\n- `create_or_update_consumer`/`delete_consumer`: Manage consumers\n- `get_credential`/`create_or_update_credential`/`delete_credential`/: Manage consumer credentials\n- `create_consumer_group`/`delete_consumer_group`: Manage consumer groups\n\n## Configuration in AI client\n\n### Prerequisite\n\nFollow the APISIX [Getting Started](https://docs.api7.ai/apisix/getting-started/) guide to set up and run APISIX.\n\n### Installing via Smithery\n\nTo install APISIX Model Context Protocol Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@api7/apisix-mcp):\n\n```bash\nnpx -y @smithery/cli install @api7/apisix-mcp --client claude\n```\n\n### Using npm\n\nConfigure your AI client (Cursor, Claude, Copilot, etc.) with following settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"apisix-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"apisix-mcp\"\n      ],\n      \"env\": {\n        \"APISIX_SERVER_HOST\": \"your-apisix-server-host\",\n        \"APISIX_SERVER_PORT\": \"your-apisix-server-port\",\n        \"APISIX_ADMIN_API_PORT\": \"your-apisix-admin-api-port\",\n        \"APISIX_ADMIN_API_PREFIX\": \"your-apisix-admin-api-prefix\",\n        \"APISIX_ADMIN_KEY\": \"your-apisix-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Using source code\n\nFirst clone the apisix-mcp repository:\n\n```bash\ngit clone https://github.com/api7/apisix-mcp.git\ncd apisix-mcp\n```\n\nInstall the dependencies and build the project:\n\n```bash\npnpm install\npnpm build\n```\n\nConfigure your AI client (Cursor, Claude, Copilot, etc.) with following settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"apisix-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"your-apisix-mcp-path/dist/index.js\"\n      ],\n      \"env\": {\n        \"APISIX_SERVER_HOST\": \"your-apisix-server-host\",\n        \"APISIX_SERVER_PORT\": \"your-apisix-server-port\",\n        \"APISIX_ADMIN_API_PORT\": \"your-apisix-admin-api-port\",\n        \"APISIX_ADMIN_API_PREFIX\": \"your-apisix-admin-api-prefix\",\n        \"APISIX_ADMIN_KEY\": \"your-apisix-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable                  | Description                                 | Default Value                      |\n| ------------------------- | ------------------------------------------- | ---------------------------------- |\n| `APISIX_SERVER_HOST`      | Host that have access to your APISIX server | `http://127.0.0.1`                 |\n| `APISIX_SERVER_PORT`      | APISIX server port                          | `9080`                             |\n| `APISIX_ADMIN_API_PORT`   | Admin API port                              | `9180`                             |\n| `APISIX_ADMIN_API_PREFIX` | Admin API prefix                            | `/apisix/admin`                    |\n| `APISIX_ADMIN_KEY`        | Admin API authentication key                | `edd1c9f034335f136f87ad84b625c8f1` |\n\nTo view or modify Admin API configurations in APISIX, refer to the [Admin API](https://apisix.apache.org/docs/apisix/admin-api) documentation.\n\n\n## Resources \n\n### Open MCP Marketplace API Support \n![MCP Marketplace User Review Rating Badge](http://www.deepnlp.org/api/marketplace/svg?api7/apisix-mcp)|[GitHub](https://github.com/AI-Agent-Hub/mcp-marketplace)|[Doc](http://www.deepnlp.org/doc/mcp_marketplace)|[MCP Marketplace](http://www.deepnlp.org/store/ai-agent/mcp-server)\n- Allow AI App/Agent/LLM to find this MCP Server via common python/typescript API, search and explore relevant servers and tools\n\n***Example: Search Server and Tools***\n```python\n    import anthropic\n    import mcp_marketplace as mcpm\n\n    result_q = mcpm.search(query=\"apisix mcp\", mode=\"list\", page_id=0, count_per_page=100, config_name=\"deepnlp\") # search server by category choose various endpoint\n    result_id = mcpm.search(id=\"api7/apisix-mcp\", mode=\"list\", page_id=0, count_per_page=100, config_name=\"deepnlp\")      # search server by id choose various endpoint \n    tools = mcpm.list_tools(id=\"api7/apisix-mcp\", config_name=\"deepnlp_tool\")\n\n    # Call Claude to Choose Tools Function Calls \n    client = anthropic.Anthropic()\n    response = client.messages.create(model=\"claude-3-7-sonnet-20250219\", max_tokens=1024, tools=tools, messages=[])\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapi7%2Fapisix-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapi7%2Fapisix-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapi7%2Fapisix-mcp/lists"}