APISIX 模型上下文协议 (MCP) 服务器

铁匠徽章

APISIX 模型上下文协议 (MCP) 服务器用于桥接大型语言模型 (LLM) 和 APISIX Admin API。它旨在通过兼容 MCP 的 AI 客户端，实现基于自然语言的交互，以便查看和管理 APISIX 中的资源。

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

支持行动

常见操作

get_resource ：按类型检索资源（路线、服务、上游等）
delete_resource ：通过 ID 删除资源
send_request_to_gateway ：向 APISIX 网关发送一个或多个请求

API资源操作

create_route / update_route / delete_route ：管理路线
create_service / update_service / delete_service ：管理服务
create_upstream / update_upstream / delete_upstream ：管理上游
create_ssl / update_ssl / delete_ssl ：管理 SSL 证书
create_or_update_proto ：管理 protobuf 定义
create_or_update_stream_route ：管理流路线

插件操作

get_all_plugin_names ：获取所有可用的插件名称
get_plugin_info / get_plugins_by_type / get_plugin_schema ：检索插件配置
create_plugin_config / update_plugin_config ：管理插件配置
create_global_rule / update_global_rule ：管理插件全局规则
get_plugin_metadata / create_or_update_plugin_metadata / delete_plugin_metadata ：管理插件元数据

安全配置

get_secret_by_id / create_secret / update_secret ：管理秘密
create_or_update_consumer / delete_consumer ：管理消费者
get_credential / create_or_update_credential / delete_credential /：管理消费者凭证
create_consumer_group / delete_consumer_group ：管理消费者组

Related MCP server: Upstash MCP Server

AI客户端中的配置

先决条件

按照 APISIX入门指南设置并运行 APISIX。

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 APISIX 模型上下文协议服务器：

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

使用 npm

使用以下设置配置您的 AI 客户端（Cursor、Claude、Copilot 等）：

{ "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" } } } }

使用源代码

首先克隆 apisix-mcp 存储库：

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

安装依赖项并构建项目：

pnpm install pnpm build

使用以下设置配置您的 AI 客户端（Cursor、Claude、Copilot 等）：

{ "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" } } } }

环境变量

多变的	描述	默认值
`APISIX_SERVER_HOST`	有权访问您的 APISIX 服务器的主机	`http://127.0.0.1`
`APISIX_SERVER_PORT`	APISIX 服务器端口	`9080`
`APISIX_ADMIN_API_PORT`	管理 API 端口	`9180`
`APISIX_ADMIN_API_PREFIX`	管理 API 前缀	`/apisix/admin`
`APISIX_ADMIN_KEY`	管理 API 身份验证密钥	`edd1c9f034335f136f87ad84b625c8f1`