MCP 架構(gòu)圖

目前已經(jīng)有大量服務(wù)和應(yīng)用基于 MCP 實(shí)現(xiàn),例如我們可以使用 GitHub-MCP,用自然語言提交代碼、創(chuàng)建 PR;利用 Figma MCP,讓 AI 直接生成 UI 圖,接入 Browser-tools-MCP 后,甚至還能讓 cursor 根據(jù)瀏覽器控制臺(tái)中的元素節(jié)點(diǎn)和打印的日志進(jìn)行代碼調(diào)試。在 MCP 官方倉庫里,提供了諸如 Google Drive、Slack、Git 以及多種數(shù)據(jù)庫的 MCP 服務(wù)。而且它作為一項(xiàng)開放標(biāo)準(zhǔn),MCP 獲得了 AI 社區(qū)的廣泛認(rèn)可,眾多第三方開發(fā)者紛紛投身其中,開發(fā)了各類 MCP 服務(wù),每天都有數(shù)百個(gè)新的 MCP 服務(wù)問世。Anthropic 作為發(fā)布者,也一直在積極推動(dòng) MCP 的發(fā)展,持續(xù)優(yōu)化協(xié)議的實(shí)現(xiàn),同時(shí)大力開展對(duì)開發(fā)者的相關(guān)教育工作。

關(guān)于 APISIX-MCP

MCP 協(xié)議的興起為傳統(tǒng)應(yīng)用提供了新的技術(shù)路徑。基于 MCP 的標(biāo)準(zhǔn)化接入能力,我們開發(fā)了 APISIX-MCP 服務(wù),并在開源版本 Apache APISIX 上實(shí)現(xiàn)了大語言模型與 APISIX Admin-API 的對(duì)接,支持通過自然語言交互完成 APISIX 網(wǎng)關(guān)資源的查詢與管理,目前 APISIX-MCP 已經(jīng)實(shí)現(xiàn)下列操作:

通用操作

get_resource

: 按類型檢索資源(路由、服務(wù)、上游等)

delete_resource

: 按 ID 刪除資源

API 資源操作

create_route

/

update_route

/

delete_route

: 管理路由

create_service

/

update_service

/

delete_service

: 管理服務(wù)

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

: 管理插件全局規(guī)則

get_plugin_metadata

/

create_or_update_plugin_metadata

/

delete_plugin_metadata

: 管理插件元數(shù)據(jù)

安全配置

get_secret_by_id

/

create_secret

/

update_secret

: 管理密鑰

create_or_update_consumer

/

delete_consumer

: 管理消費(fèi)者

get_credential

/

create_or_update_credential

/

delete_credential

: 管理消費(fèi)者憑證

create_consumer_group

/

delete_consumer_group

: 管理消費(fèi)者組

如何使用 APISIX-MCP

APISIX-MCP 目前已經(jīng)開源并發(fā)布到了 npm(apisix-mcp npm[1])及 Github (apisix-mcp GitHub[2]),你可以通過任一支持 MCP 服務(wù)的 AI 客戶端進(jìn)行配置,例如 claude desktop,cursor 或者通過 Vscode 中的 cline 插件。這里以 cursor 為例為大家演示如何配置。

  1. 首先打開 curosr,點(diǎn)擊右上角設(shè)置圖標(biāo),進(jìn)入設(shè)置頁面。

image

進(jìn)入 Cursor 設(shè)置頁面

  1. 點(diǎn)擊添加 "Add new global MCP server" 按鈕,我們會(huì)進(jìn)入一個(gè)
mcp.json

配置文件。

// mcp.json
{"mcpServers": {? ? "apisix-mcp": {? ? ? "command": "npx",? ? ? "args": ["-y", "apisix-mcp"],? ? ? "env": {? ? ? ? "APISIX_SERVER_HOST": "your-apisix-server-host",? ? ? ? "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"? ? ? }? ? }? }}

在配置文件中的

mcpServers

字段中,新增名為

apisix-mcp

的服務(wù),這個(gè)名稱也可以自行更改,然后配置運(yùn)行 MCP 服務(wù)的命令。

command

npx

意為使用 node.js 自帶的命令執(zhí)行工具運(yùn)行腳本,

args

-y

apisix-mcp

,

-y

代表在執(zhí)行命令的時(shí)候需要先安裝依賴,

apisix-mcp

則為 npm 中的包名。在

env

字段中,我們可以填入 APISIX 服務(wù)訪問地址,Admin API 的端口、前綴和以及用于認(rèn)證 key,這些環(huán)境變量都有默認(rèn)值,如果你直接啟動(dòng) APISIX 后沒有做任何自定義配置就無需傳入

env

字段,各個(gè)環(huán)境變量對(duì)應(yīng)的默認(rèn)值如下:

變量描述 默認(rèn)值
APISIX_SERVER_HOST Host that have access to your APISIX server http://127.0.0.1
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
  1. 配置添加完成后,我們回到 cursor 的 MCP 配置頁面中,如果配置成功,MCP Servers 中會(huì)展示 apisix-mcp 服務(wù)已經(jīng)啟用的綠色小燈,且可以順利讀取到 MCP 服務(wù)中提供的所有工具。

image

Cursor 配置成功示例

由于目前不同的 MCP 客戶端的實(shí)現(xiàn)有所不同,如果發(fā)現(xiàn)配置失敗,我們也可以參考 APISIX-MCP GitHub 倉庫中的文檔,利用源碼構(gòu)建項(xiàng)目后再重新修改配置文件。

  1. 此時(shí)我們打開右側(cè)對(duì)話欄,選擇 agent 類型,模型選擇 claude-sonnet-3.5/3.7 或 gpt 4o:

image

選擇 AI Agent 模型

  1. 然后我們可以輸入相關(guān)的操作指令看看 MCP 服務(wù)是否能正常工作,這里我們根據(jù) APISIX 文檔中的 Getting Started 中的流程進(jìn)行操作,在對(duì)話框中輸入以下內(nèi)容,并發(fā)送對(duì)話。

"Help me create a route with path /api for accessing https://httpbin.org upstream, need to configure cors and rate limit plugin appropriately. Print the route information to me after configuring"

中文翻譯:“幫我創(chuàng)建一條路徑為 /api 的路由,用于訪問上游 https://http-bin.org,需要配置 CORS 和 限流限速插件。配置完成后把路由信息打印給我”

  1. 接下來我們會(huì)在 cursor 中看到類似下面視頻中 MCP 工具調(diào)用過程流程,由于 AI 大模型本身響應(yīng)具有隨機(jī)性,所以每次執(zhí)行的操作不一定與示例中相同。這里開啟了自動(dòng)執(zhí)行模式(YOLO Mode)允許 cursor 自動(dòng)調(diào)用 mcp 服務(wù)中的所有工具,從視頻中我們可以看到 AI 根據(jù)我們的需求:
get_plugins_list

獲取所有插件的名稱

get_plugin_schema

去查看不同插件的詳細(xì)配置信息調(diào)用

create_rotue

創(chuàng)建路由調(diào)用

update_route

為路由添加前面查詢到的插件配置調(diào)用

get_route

查看路由是否配置成功,路由配置是否正確

  1. 最終我們通過一句話創(chuàng)建出了如下配置的路由:
httpbin
/api/*
GET

,

POST

,

PUT

,

DELETE

,

PATCH

,

HEAD

,

OPTIONS
allow_origins: *
allow_methods: *
allow_headers: *
expose_headers: X-Custom-Header
max_age: 3600
allow_credential:?false
count: 100
time_window: 60
key: remote_addr
rejected_code: 429
policy:?local
type: roundrobin (負(fù)載均衡策略采用輪詢)
upstream ndoe: httpbin.org:443 (指向的后端服務(wù)地址)

通過 AI 進(jìn)行操作的優(yōu)勢(shì)

上述過程中,我們僅通過一輪對(duì)話,就通過自然語言的方式讓 AI 幫我創(chuàng)建一個(gè)配置了跨域和限流限速的路由,相較于自己創(chuàng)建路由,借助 AI 來操作具有諸多優(yōu)勢(shì):

而這些實(shí)現(xiàn)都得益于 MCP 協(xié)議將我們的需求進(jìn)行語意解析,再根據(jù)我們的需求調(diào)用不同的工具,最終通過 Admin API 完成操作。需要注意的是,目前 APISIX-MCP 并非追求完全替代人工配置,而是著眼于優(yōu)化高頻操作場(chǎng)景的效率。其價(jià)值在配置調(diào)試和快速驗(yàn)證環(huán)節(jié)尤為突出,這種定位使其能夠與傳統(tǒng)管理方式形成有效互補(bǔ)。隨著 MCP 生態(tài)的持續(xù)發(fā)展,此類工具在 API 管理領(lǐng)域的深度集成值得期待。

總結(jié)

MCP 的出現(xiàn)為復(fù)雜 API 系統(tǒng)的智能化操作開辟了新的可能性,我們希望 APISIX-MCP 能夠幫助你快速上手 Apache APISIX。后續(xù) APISIX 將會(huì)推出更多處理 AI 流量相關(guān)的插件,也會(huì)在 API 管理方面探索更多與 AI 結(jié)合的可能性。我們相信,AI 與 API 管理的融合將持續(xù)推動(dòng)運(yùn)維效率的革新,為開發(fā)者帶來更智能、更高效的基礎(chǔ)設(shè)施管理體驗(yàn)。

參考資料

[1]?apisix-mcp npm:?https://www.npmjs.com/package/apisix-mcp

[2]?apisix-mcp GitHub:?https://github.com/api7/apisix-mcp

原文轉(zhuǎn)載自:https://mp.weixin.qq.com/s/9A68sGOLa93O5QyT613lAA

上一篇:

如何0代碼將存量 API 適配 MCP 協(xié)議?

下一篇:

DeepSeek推薦AI生圖API,用Windsurf接入API,完善AI生圖功能
#你可能也喜歡這些API文章!

我們有何不同?

API服務(wù)商零注冊(cè)

多API并行試用

數(shù)據(jù)驅(qū)動(dòng)選型,提升決策效率

查看全部API→
??

熱門場(chǎng)景實(shí)測(cè),選對(duì)API

#AI文本生成大模型API

對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)

#AI深度推理大模型API

對(duì)比大模型API的邏輯推理準(zhǔn)確性、分析深度、可視化建議合理性

10個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)