APISIX-MCP

APISIX Model Context Protocol (MCP) Server

APISIX 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.

https://github.com/user-attachments/assets/081e878c-225e-4ff8-a9c5-5813f4784cfe

Support Operations

Common Operations

get_resource: Retrieve resources by type (routes, services, upstreams, etc.)
delete_resource: Remove resources by ID
send_request_to_gateway: Send a request or multiple requests to the APISIX gateway

API Resources Operations

create_route/update_route/delete_route: Manage routes
create_service/update_service/delete_service: Manage services
create_upstream/update_upstream/delete_upstream: Manage upstream
create_ssl/update_ssl/delete_ssl: Manage SSL certificates
create_or_update_proto: Manage protobuf definitions
create_or_update_stream_route: Manage stream routes

Plugin Operations

get_all_plugin_names: Get all available plugin names
get_plugin_info/get_plugins_by_type/get_plugin_schema: Retrieve plugins configuration
create_plugin_config/update_plugin_config: Manage plugin configurations
create_global_rule/update_global_rule: Manage plugin global rules
get_plugin_metadata/create_or_update_plugin_metadata/delete_plugin_metadata: Manage plugin metadata

Security Configuration

get_secret_by_id/create_secret/update_secret: Manage secrets
create_or_update_consumer/delete_consumer: Manage consumers
get_credential/create_or_update_credential/delete_credential/: Manage consumer credentials
create_consumer_group/delete_consumer_group: Manage consumer groups

Configuration in AI client

Prerequisite

Follow the APISIX Getting Started guide to set up and run APISIX.

Installing via Smithery

To install APISIX Model Context Protocol Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @api7/apisix-mcp --client claude

Using npm

Configure your AI client (Cursor, Claude, Copilot, etc.) with following settings:

{
  "mcpServers": {
    "apisix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apisix-mcp"
      ],
      "env": {
        "APISIX_SERVER_HOST": "your-apisix-server-host",
        "APISIX_SERVER_PORT": "your-apisix-server-port",
        "APISIX_ADMIN_API_PORT": "your-apisix-admin-api-port",
        "APISIX_ADMIN_API_PREFIX": "your-apisix-admin-api-prefix",
        "APISIX_ADMIN_KEY": "your-apisix-api-key"
      }
    }
  }
}

Using source code

First clone the apisix-mcp repository:

git clone https://github.com/api7/apisix-mcp.git
cd apisix-mcp

Install the dependencies and build the project:

pnpm install
pnpm build

Configure your AI client (Cursor, Claude, Copilot, etc.) with following settings:

{
  "mcpServers": {
    "apisix-mcp": {
      "command": "node",
      "args": [
        "your-apisix-mcp-path/dist/index.js"
      ],
      "env": {
        "APISIX_SERVER_HOST": "your-apisix-server-host",
        "APISIX_SERVER_PORT": "your-apisix-server-port",
        "APISIX_ADMIN_API_PORT": "your-apisix-admin-api-port",
        "APISIX_ADMIN_API_PREFIX": "your-apisix-admin-api-prefix",
        "APISIX_ADMIN_KEY": "your-apisix-api-key"
      }
    }
  }
}

Environment Variables

Variable	Description	Default Value
`APISIX_SERVER_HOST`	Host that have access to your APISIX server	`http://127.0.0.1`
`APISIX_SERVER_PORT`	APISIX server port	`9080`
`APISIX_ADMIN_API_PORT`	Admin API port	`9180`
`APISIX_ADMIN_API_PREFIX`	Admin API prefix	`/apisix/admin`
`APISIX_ADMIN_KEY`	Admin API authentication key	`edd1c9f034335f136f87ad84b625c8f1`

To view or modify Admin API configurations in APISIX, refer to the Admin API documentation.

Resources

Open MCP Marketplace API Support

MCP Marketplace User Review Rating Badge |GitHub|Doc|MCP Marketplace

Allow AI App/Agent/LLM to find this MCP Server via common python/typescript API, search and explore relevant servers and tools

Example: Search Server and Tools

    import anthropic
    import mcp_marketplace as mcpm

    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
    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 
    tools = mcpm.list_tools(id="api7/apisix-mcp", config_name="deepnlp_tool")

    # Call Claude to Choose Tools Function Calls 
    client = anthropic.Anthropic()
    response = client.messages.create(model="claude-3-7-sonnet-20250219", max_tokens=1024, tools=tools, messages=[])

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

APISIX 模型上下文协议 (MCP) 服务器将大型语言模型 (LLM) 与 APISIX 管理 API 连接起来。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Exa MCP Server
exa-labs
A
security
A
license
A
quality
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Last updated -
1
2,364
2,130
MIT License
Upstash MCP Serverofficial
upstash
A
security
A
license
A
quality
Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. In this repository, we provide an installer as well as an MCP Server for Upstash Developer API's.
Last updated -
16
82
48
MIT License
@lex-tools/codebase-context-dumperofficial
lex-tools
A
security
A
license
A
quality
A Model Context Protocol (MCP) server designed to easily dump your codebase context into Large Language Models (LLMs).
Last updated -
1
10
2
Apache 2.0
FastAPI MCP Server
purity3
-
security
A
license
-
quality
A high-performance Model Context Protocol (MCP) server designed for large language models, enabling real-time communication between AI models and applications with support for session management and intelligent tool registration.
Last updated -
2
MIT License

View all related MCP servers