使用自然语言管理 API：APISIX MCP Server

什么是 MCP？

最近 MCP 比较火，很多人也已经介绍过。贴一下官方介绍。MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. MCP 是一种协议，提供了一种标准化的方式将 AI 模型连接到不同的数据源和工具。更多可参考官方文档：https://modelcontextprotocol.io/introduction

什么是 APISIX MCP Server？

APISIX MCP 是一个连接大语言模型与 APISIX 管理 API 的桥梁。通过它，我们可以用自然语言来查看和管理 APISIX 中的各种资源，不再需要记忆复杂的 API 格式和参数。

APISIX MCP Server 支持哪些功能？

目前，APISIX MCP 支持以下主要操作：

通用操作
- 获取资源：查询各类资源（路由、服务、上游等）
- 删除资源：通过 ID 移除资源
API 资源操作
- 路由管理：创建、更新、删除路由
- 服务管理：创建、更新、删除服务
- 上游管理：创建、更新、删除上游服务
- SSL 证书管理：创建、更新、删除 SSL 证书
插件操作
- 获取插件信息：查看可用插件、插件配置等
- 插件配置管理：创建和更新插件配置
- 全局规则管理：创建和更新插件全局规则
- 插件元数据管理：获取、创建、更新和删除插件元数据
安全配置
- 密钥管理：获取、创建和更新密钥
- 消费者管理：创建、更新和删除消费者
- 凭证管理：获取、创建、更新和删除消费者凭证
- 消费者组管理：创建和删除消费者组

如何配置 APISIX MCP Server?

如果你还没有安装 APISIX，可以使用一行命令运行部署 APISIX
```
curl -sL https://run.api7.ai/apisix/quickstart | sh
```
更多可参考: https://apisix.apache.org/docs/apisix/getting-started/README/

AI 客户端配置 MCP Servers:

使用线上 npm 包（推荐）只需在 AI 客户端中添加以下配置：

{
  "mcpServers": {
    "apisix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apisix-mcp"
      ],
      "env": {
        // 以下参数在 getting started 中可以直接删除，保留为空即可
        "APISIX_SERVER_HOST": "你的APISIX服务器主机",
        "APISIX_ADMIN_API_PORT": "你的APISIX管理API端口",
        "APISIX_ADMIN_API_PREFIX": "你的APISIX管理API前缀",
        "APISIX_ADMIN_KEY": "你的APISIX API密钥"
      }
    }
  }
}

如果你想自行开发调试，也可以使用源代码的方式首先克隆 APISIX MCP 仓库：

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

安装依赖并构建项目：

pnpm install
pnpm build

然后在 AI 客户端中添加配置：

{
  "mcpServers": {
    "apisix-mcp": {
      "command": "node",
      "args": [
        "你的apisix-mcp路径/build/index.js"
      ],
      "env": {
        "APISIX_SERVER_HOST": "你的APISIX服务器主机",
        "APISIX_ADMIN_API_PORT": "你的APISIX管理API端口",
        "APISIX_ADMIN_API_PREFIX": "你的APISIX管理API前缀",
        "APISIX_ADMIN_KEY": "你的APISIX API密钥"
      }
    }
  }
}

环境变量说明

变量名描述默认值

APISIX_SERVER_HOST

可访问 APISIX 服务器的主机

http://127.0.0.1
APISIX_ADMIN_API_PORT

管理 API 端口

9180
APISIX_ADMIN_API_PREFIX

管理 API 前缀

/apisix/admin
APISIX_ADMIN_KEY

管理 API 认证密钥

edd1c9f034335f136f87ad84b625c8f1

使用体验

目前来看 deepseek R1 和 Claude 3.7 模型的使用体验是比较好的，能够更好理解用户意图并选择正确的 tools 进行调用

创建路由

$ curl http://127.0.0.1:9080/ip
{
  "origin": "192.168.155.1, 118.163.197.13"
}

总结

APISIX MCP 为 API 网关管理带来了全新的交互方式，让我们能够用自然语言来完成复杂的 API 管理任务。一定程度上提高了效率，降低了学习的门槛。

原文转载自：https://mp.weixin.qq.com/s/3pEwlE_PUHf7_RbCH4b_kw