mcp-apisix
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | HTTP 监听地址(stdio 忽略) | 0.0.0.0 |
| MCP_PORT | No | HTTP 监听端口(stdio 忽略) | 8000 |
| MCP_LOG_LEVEL | No | 日志级别:debug / info / warning / error | info |
| MCP_TRANSPORT | No | 传输协议:stdio / sse / streamable-http | stdio |
| APISIX_TIMEOUT | No | 请求超时秒数 | 30 |
| MCP_AUTH_TOKEN | No | 非空时启用 Bearer Token 认证 | |
| APISIX_BASE_URL | No | Admin API 地址,格式 scheme://host[:port] | http://localhost:9180 |
| APISIX_INSECURE | No | 跳过 TLS 证书验证(自签名 / 内部 CA 场景) | false |
| APISIX_ADMIN_KEY | Yes | 必填。映射到 X-API-KEY 请求头 | |
| APISIX_READ_ONLY | No | 只读模式(禁用写工具) | true |
| APISIX_API_VERSION | No | 响应格式:auto(自动探测)/ v2 / v3 | auto |
| MCP_STATELESS_HTTP | No | 启用无状态 HTTP(适配 Serverless) | false |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| apisix_list_routesA | 查询路由列表。 支持按 name / uri / label 过滤(v3 格式原生支持),以及 service_id / upstream_id 引用过滤(需 APISIX ≥3.13)。v2 格式下过滤参数被静默忽略,返回结果中会显式告知。 |
| apisix_get_routeA | 查询单个路由的完整配置(不裁剪、不截断)。 |
| apisix_list_servicesC | 查询服务列表。 |
| apisix_get_serviceA | 查询单个服务的完整配置。 |
| apisix_list_upstreamsC | 查询上游列表。 |
| apisix_get_upstreamA | 查询单个上游的完整配置。 |
| apisix_list_consumersA | 查询消费者列表。凭据字段已脱敏(plugins 子树内的 key/password/secret 等被遮盖)。 |
| apisix_get_consumerA | 查询单个消费者的完整配置。凭据字段已脱敏。 |
| apisix_list_global_rulesA | 查询全局规则列表。有意不提供 get 工具(资源数量少,list 即可获得全部)。 |
| apisix_list_stream_routesA | 查询流路由列表。有意不提供 get 工具。 |
| apisix_list_plugin_configsB | 查询插件配置列表。有意不提供 get 工具。 |
| apisix_list_pluginsA | 查询插件名列表(按 priority 降序,不含 schema)。 需要字段定义时另调 apisix_get_plugin_schema。 |
| apisix_get_plugin_schemaA | 查询单个插件的字段定义、类型、必填项、默认值(含 metadata_schema 与 consumer_schema)。 APISIX 插件字段跨版本变化频繁(如 disable 移入 _meta),提供真实 schema 优于硬编码规则。 |
| apisix_get_server_infoA | 查询客户端探测层状态(响应格式 v2/v3、可用能力清单)。 返回的是 mcp-apisix 客户端对 APISIX 的探测结果,非 APISIX 节点运行时信息 (Admin API 不提供节点信息端点)。告知 AI 当前环境的能力边界, 用于判断分页/过滤/校验等能力是否可用。 |
| apisix_validate_resource_configA | 校验资源配置是否符合 JSON schema(需 APISIX ≥3.5)。 仅校验 JSON schema,不校验引用存在性与插件配置合法性。 通过不代表写入必定成功。<3.5 实例上优雅降级。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_server_info | 客户端探测层状态(动态返回当前探测结果,非 APISIX 节点运行时信息)。 会话建立时探测层尚无数据,返回配置值 + 探测状态"未知"; 会话中途读取时可能已有探测结果。每次读取动态返回,非静态快照。 |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhouweico/mcp-apisix'
If you have feedback or need assistance with the MCP directory API, please join our Discord server