YApi MCP Server

连接YApi平台,高效获取和管理API接口信息的MCP工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:YApi MCP Server。
它的用途是:连接YApi平台,高效获取和管理API接口信息的MCP工具。
完整的 Skill 内容见:https://321skill.com/skills/yapi-mcp-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我查一下用户模块的登录接口需要哪些参数?” 它会通过此Skill连接到YApi,找到对应的项目接口,并返回接口的路径、请求方法、请求头、参数说明和响应示例。或者你可以说:“对比一下v1和v2版本的用户查询接口有什么区别?” AI会提取两个版本接口的详细信息并进行对比分析。

介绍

YApi MCP Server 解决了开发者在项目开发过程中频繁查阅、核对API接口文档的低效问题。通过MCP协议,它能将YApi平台上的接口信息无缝集成到你的AI编程助手(如Claude Desktop、Cursor)中,让你无需离开编辑器就能查询接口详情。

使用时,你需要先配置好YApi平台的访问地址和Token。之后,在支持MCP的AI工具中,就可以直接通过自然语言提问来查询接口路径、参数、响应结构等信息,AI助手会基于该Skill提供的数据给出精准回答。

这个Skill非常适合需要频繁与后端API交互的开发人员,尤其是团队协作时,能确保大家使用的是最新、最准确的接口定义。

建议在团队项目中统一配置,并确保YApi平台上的接口文档维护及时。初次使用请仔细核对配置信息,避免因Token权限或地址错误导致连接失败。

核心特点

与通用的API查询工具不同,它深度集成YApi这一国内广泛使用的API管理平台,能直接拉取项目分组下的结构化接口数据,而非简单爬取网页。其MCP协议实现使其能作为AI编程助手的“数据源”,实现对话式、上下文感知的接口查询。

注意事项

仅支持YApi平台,无法直接用于Swagger、Apifox等其他API管理工具。

常见问题

如何获取YApi的Token?

登录YApi平台,在个人设置或项目设置中生成访问Token。

支持哪些AI工具?

支持所有实现了MCP客户端协议的工具,如Claude Desktop、Cursor、Windsurf等。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/yapi-mcp-server/raw/index.md 读取 YApi MCP Server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。