
APISIX-MCP:利用 AI + MCP 擁抱 API 智能化管理
這種方式不僅容易導(dǎo)致數(shù)據(jù)同步不一致,還阻礙了團(tuán)隊(duì)成員之間的協(xié)作,最終影響開(kāi)發(fā)效率。面對(duì)這些問(wèn)題,如果有一個(gè)一體化的平臺(tái),能將 API 的設(shè)計(jì)、開(kāi)發(fā)、測(cè)試等所有環(huán)節(jié)整合在一起,會(huì)是多么方便!在這樣的平臺(tái)上,團(tuán)隊(duì)成員可以共享一份清晰的 API 文檔,后端開(kāi)發(fā)可以根據(jù)接口文檔快速開(kāi)發(fā)并調(diào)試 API。前端開(kāi)發(fā)可以輕松調(diào)用 API 并獲取 Mock 數(shù)據(jù),測(cè)試工程師也能高效地進(jìn)行 API 測(cè)試工作。這樣一來(lái),整個(gè)團(tuán)隊(duì)的協(xié)作將會(huì)更加順暢,開(kāi)發(fā)效率也會(huì)顯著提高。今天我們介紹的這款A(yù)PI管理神器– Apifox ,正是這樣一個(gè)一站式 API 開(kāi)發(fā)協(xié)作平臺(tái)!它集 API 設(shè)計(jì)、API 開(kāi)發(fā)、API 調(diào)試、API 管理、 API 文檔、API Mock 和自動(dòng)化測(cè)試等功能于一體,為我們的 API 項(xiàng)目提供一站式的解決方案。
在?Apifox?中,所有操作都圍繞 API 定義?(API specification)?展開(kāi),每個(gè)角色都可以直接利用設(shè)計(jì)好的 API 來(lái)發(fā)送請(qǐng)求、創(chuàng)建接口用例、生成 Mock 數(shù)據(jù)和發(fā)布文檔。
.yaml
或
.json
文件),并支持使用迭代分支來(lái)設(shè)計(jì) API。
后端開(kāi)發(fā):可以直接根據(jù)定義好的 API 來(lái)發(fā)送請(qǐng)求,或生成后端業(yè)務(wù)代碼。
前端開(kāi)發(fā):不用等后端完成,可以直接基于 API 定義生成 Mock 數(shù)據(jù)。
測(cè)試工程師:可以基于 API 定義自動(dòng)生成接口用例,提供可視化界面來(lái)編排測(cè)試場(chǎng)景,并集成 CI/CD 流水線。
API 文檔維護(hù)者:可以一鍵生成規(guī)范的 API 文檔,文檔會(huì)隨 API 定義的更新自動(dòng)保持同步。
性能測(cè)試人員:提供專(zhuān)門(mén)的性能測(cè)試功能。
Apifox 是專(zhuān)門(mén)為 API 設(shè)計(jì)和開(kāi)發(fā)團(tuán)隊(duì)量身定制的協(xié)作平臺(tái)。
Apifox 提供了一系列豐富且強(qiáng)大的功能,幫助你在開(kāi)發(fā)和管理 API 時(shí)更加高效:
Apifox MCP Server,可以將 Apifox 的接口文檔提供給 Cursor 等支持 AI 編程的 IDE,或其他支持 MCP 的 AI 工具。
有了 Apifox MCP Server,我們開(kāi)發(fā)者就可以通過(guò) AI 助手完成以下工作:根據(jù)接口文檔生成或修改代碼、搜索接口文檔內(nèi)容等等,至于通過(guò)這個(gè)接口文檔數(shù)據(jù)還能讓AI幫我們完成哪些更多更強(qiáng)大的任務(wù),這個(gè)就需要我們自己盡情的發(fā)揮想象力,哈哈。
Apifox MCP Server 可以將項(xiàng)目?jī)?nèi)的 API 文檔提供給 AI 使用。
在 Apifox 生成 API 個(gè)人訪問(wèn)令牌:打開(kāi) Apifox,將鼠標(biāo)懸停在頁(yè)面右上角的頭像上,點(diǎn)擊 “賬號(hào)設(shè)置 -> API 訪問(wèn)令牌”,創(chuàng)建新的 API 訪問(wèn)令牌,替換下面配置文件中的
獲取 Apifox 項(xiàng)目 ID:打開(kāi) Apifox 里對(duì)應(yīng)的項(xiàng)目,在左側(cè)邊欄點(diǎn)擊 “項(xiàng)目設(shè)置”,在 “基本設(shè)置” 頁(yè)面即可復(fù)制項(xiàng)目ID,拿到項(xiàng)目ID,替換下面配置文件中的
;
在 Cursor 中配置 MCP:編輯 MCP 配置文件:打開(kāi)Cursor編輯器,點(diǎn)擊右上角“設(shè)置”圖標(biāo),選擇左側(cè)“MCP”選項(xiàng),點(diǎn)擊“+ Add new global MCP server“按鈕。
添加配置內(nèi)容:在打開(kāi)的
mcp.json
文件中添加以下配置,注意替換
和
為你自己的值:
{
"mcpServers": {
"API 文檔": {
"command":?"npx",
"args": [
"-y",
"apifox-mcp-server@latest",
"--project="
],
"env": {
"APIFOX_ACCESS_TOKEN":?""
}
}
}
}
驗(yàn)證配置:配置完成后,你可以通過(guò)向 AI 詢(xún)問(wèn)以驗(yàn)證連接是否正常工作(Agent 模式)。例如:請(qǐng)通過(guò) MCP 獲取 API 文檔,并告訴我項(xiàng)目中有幾個(gè)接口,如果 AI 能夠返回你 Apifox 項(xiàng)目中的 API 信息,說(shuō)明連接成功。
安裝 Cline 插件:在 VSCode 擴(kuò)展市場(chǎng)搜索并安裝 “Cline” 插件;配置 MCP 服務(wù)器:打開(kāi) Cline 面板,點(diǎn)擊 「MCP Servers > Configure MCP Servers」。
在打開(kāi)的
.json
文件中添加以下配置,注意替換
和
為你自己的值:
{
"mcpServers": {
"API 文檔": {
"command":?"npx",
"args": [
"-y",
"apifox-mcp-server@latest",
"--project="
],
"env": {
"APIFOX_ACCESS_TOKEN":?""
}
}
}
}
驗(yàn)證配置:配置完成后,你可以通過(guò)向 AI 詢(xún)問(wèn)以驗(yàn)證連接是否正常工作。例如:請(qǐng)通過(guò) MCP 獲取 API 文檔,并告訴我項(xiàng)目中有幾個(gè)接口。如果 AI 能夠返回你 Apifox 項(xiàng)目中的 API 信息,說(shuō)明連接成功。
Apifox MCP Server 可以將公開(kāi)發(fā)布的在線文檔提供給 AI 使用,僅支持公開(kāi)發(fā)布、任何人都可以直接訪問(wèn)的在線文檔。不支持設(shè)置了密碼、郵箱白名單、IP 白名單的在線文檔。如果不希望公開(kāi)接口文檔,僅僅是內(nèi)部人員可以訪問(wèn)。
≥ 2.7.2
開(kāi)啟 MCP 服務(wù):進(jìn)入Apifox項(xiàng)目,依次點(diǎn)擊“分享文檔 -> 發(fā)布文檔站 -> AI 功能”,開(kāi)啟 MCP 服務(wù)。
獲取配置文件:開(kāi)啟后,訪問(wèn)在線文檔的接口時(shí),頁(yè)面將顯示“AI 編程(使用 MCP)”按鈕。
點(diǎn)擊后,將彈出詳細(xì)的使用說(shuō)明和 MCP 配置文件,文件內(nèi)已自動(dòng)填充當(dāng)前文檔的
site-id
。只需復(fù)制該配置,便可用于 IDE 中接入 MCP 服務(wù)。
編輯MCP配置文件:打開(kāi)Cursor編輯器,點(diǎn)擊右上角 “設(shè)置”圖標(biāo),選擇左側(cè)“MCP”選項(xiàng),點(diǎn)擊“+ Add new global MCP server”按鈕。
添加配置內(nèi)容:在打開(kāi)的
mcp.json
文件中,添加從 “在線文檔” 中復(fù)制的的 MCP 配置,例如:
{
"mcpServers": {
"API 文檔": {
"command":?"npx",
"args": [
"-y",
"apifox-mcp-server@latest",
"--site-id=123456"
]
}
}
}
驗(yàn)證配置:配置完成后,你可以通過(guò)向 AI 詢(xún)問(wèn)以驗(yàn)證連接是否正常工作(Agent 模式)。例如:請(qǐng)通過(guò) MCP 獲取 API 文檔,并告訴我項(xiàng)目中有幾個(gè)接口,如果 AI 能夠返回你 Apifox 項(xiàng)目中的 API 信息,說(shuō)明連接成功。
安裝 Cline 插件:在 VSCode 擴(kuò)展市場(chǎng)搜索并安裝 “Cline” 插件配置 MCP 服務(wù)器:打開(kāi) Cline 面板,點(diǎn)擊“MCP Servers>Configure MCP Servers”。
在打開(kāi)的
.json
文件中添加 “在線文檔” 中的 MCP 配置,例如:
{
"mcpServers": {
"API 文檔": {
"command":?"npx",
"args": [
"-y",
"apifox-mcp-server@latest",
"--site-id=123456"
]
}
}
}
驗(yàn)證配置:配置完成后,你可以通過(guò)向 AI 詢(xún)問(wèn)以驗(yàn)證連接是否正常工作。例如:請(qǐng)通過(guò) MCP 獲取 API 文檔,并告訴我項(xiàng)目中有幾個(gè)接口,如果 AI 能夠返回你 Apifox 項(xiàng)目中的 API 信息,說(shuō)明連接成功。
如果需要使用到多個(gè) API 文檔,在配置文件里添加配置多個(gè) MCP Server 即可(不同文檔有不同的
)。
至此,我們已經(jīng)完成了Apifox MCP 使用流程講解,大家有問(wèn)題可以評(píng)論區(qū)留言討論。
Apifox MCP 可以讓你的API 文檔與AI編程深度集成,真正實(shí)現(xiàn)“文檔即代碼”的高效開(kāi)發(fā)體驗(yàn)。想體驗(yàn)的小伙伴抓緊動(dòng)手實(shí)操起來(lái)吧。
原文轉(zhuǎn)載自:https://mp.weixin.qq.com/s/fZ-MUfNxO1OvsLKvJsY9HQ
APISIX-MCP:利用 AI + MCP 擁抱 API 智能化管理
如何0代碼將存量 API 適配 MCP 協(xié)議?
C# 與 Windows API 交互的“秘密武器”:結(jié)構(gòu)體和聯(lián)合體
免費(fèi)強(qiáng)大的API開(kāi)發(fā)和調(diào)試工具——Reqable
SpringBoot中6種API版本控制策略
更智能的Kubernetes AI推理路由:Gateway API推理擴(kuò)展
超越 API:MCP 如何成為 AI 時(shí)代的“萬(wàn)能適配器”?
從零開(kāi)始的機(jī)器學(xué)習(xí)實(shí)踐指南
2025年最佳語(yǔ)音轉(zhuǎn)文字API比較:一個(gè)報(bào)表31項(xiàng)指標(biāo)近200條數(shù)據(jù)
對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對(duì)比試用API 限時(shí)免費(fèi)