# API7 APISIX

查询和管理 API 网关路由、上游、插件、消费者与证书配置。

- 类型：MCP
- 权限：可执行操作
- 门槛：需 API Key
- 官方入口：https://docs.api7.ai/apisix/reference/apisix-mcp
- 官方仓库：https://github.com/api7/apisix-mcp
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/apisix/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

需已运行且可访问的 APISIX、Admin API 地址与管理员 Key，以及 Node.js/npx；不是仅安装 MCP 就会部署网关。

## 接入步骤

1. 先按 APISIX 官方入门配置网关，确认 Admin API 的访问地址和权限。 [官方入口](https://github.com/api7/apisix-mcp)
2. 按下方环境变量填写实际网关端口、Admin API 路径和 Key，不沿用公开示例密钥。 [官方入口](https://github.com/api7/apisix-mcp)

## 验证方法

只读列出已有路由或上游配置，核对网关；不创建或删除路由作首测。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://docs.api7.ai/apisix/reference/apisix-mcp)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "apisix": {
      "command": "npx",
      "args": [
        "-y",
        "apisix-mcp"
      ],
      "env": {
        "APISIX_SERVER_HOST": "${APISIX_SERVER_HOST}",
        "APISIX_SERVER_PORT": "9080",
        "APISIX_ADMIN_API_PORT": "9180",
        "APISIX_ADMIN_API_PREFIX": "/apisix/admin",
        "APISIX_ADMIN_KEY": "${APISIX_ADMIN_KEY}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'APISIX_SERVER_HOST=${APISIX_SERVER_HOST}' --env 'APISIX_SERVER_PORT=9080' --env 'APISIX_ADMIN_API_PORT=9180' --env 'APISIX_ADMIN_API_PREFIX=/apisix/admin' --env 'APISIX_ADMIN_KEY=${APISIX_ADMIN_KEY}' --transport stdio 'apisix' -- 'npx' '-y' 'apisix-mcp'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.apisix]
command = "npx"
args = ["-y","apisix-mcp"]
env_vars = ["APISIX_SERVER_HOST","APISIX_ADMIN_KEY"]

[mcp_servers.apisix.env]
APISIX_SERVER_PORT = "9080"
APISIX_ADMIN_API_PORT = "9180"
APISIX_ADMIN_API_PREFIX = "/apisix/admin"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://docs.api7.ai/apisix/reference/apisix-mcp)。API7 官方文档明确 APISIX MCP 工具与 npm 配置。

官方原文摘录（2026-11-05，来自上述依据）：

```
"apisix-mcp"
```

- [厂商官方接入文档](https://github.com/api7/apisix-mcp)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)