API 文档的未来:Apifox+MCP,让协作像聊天一样简单

433 阅读4分钟

大家好呀!最近我发现了一个 超级好玩的东西 ——MCP!不知道你们有没有听说过?反正我是被惊艳到了!🤩

MCP 是啥?为啥突然这么火?

MCP 是 Model Context Protocol (模型上下文协议)的缩写,是 2024 年 11 月 Claude 的公司 Anthropic 推出并开源的一个新标准。简单来说, 它就是让 AI 助手能够连接到各种第三方数据源的桥梁 ,包括你的内容库、业务工具和开发环境等等。

说白了,就是让 AI 变得更聪明、回答更准确的一种方式!

AI 为啥需要 MCP?

我们都知道,AI 大模型虽然很强,但它们的知识都是 有时效性的 ...训练数据再多,也只能知道过去的事情,根本不知道今天发生了啥!

比如你问 AI:"今天天气怎么样?",它哪知道啊!😂

所以现在的 AI 助手都加了联网搜索功能,当你问问题时,它会先去搜索引擎查一下,然后再回答你。这样就能获取最新信息啦!

但是...联网搜索解决不了所有问题啊!

我前几天试了个实验,问开启了联网搜索的 DeepSeek:"Apifox 的最新版本是多少?"

结果它告诉我是 2.6.41...

但实际上 Apifox 都已经更新到 2.7.2 了好吗!差了整整 10 个版本! 人已麻...😅

这就是问题所在!对于 公开信息 ,联网搜索还行,但如果是 企业内部信息 或者 你自己系统里的数据 ,搜索引擎根本搜不到啊!

自建 AI 代理:把自己的数据喂给 AI

聪明的开发者们想出了解决方案:自己搭建 AI 代理,通过 API 把自己系统的数据提供给 AI 助手。

比如,我们可以把 Apifox 的更新日志通过 API 暴露出来,然后设计一个流程:当有人问 Apifox 版本时,就调用这个 API,把结果给 AI,这样 AI 就能回答正确了!

但是...这样做太麻烦了!每个数据源、每个 AI 助手都要开发不同的连接器, 这波操作也太复杂了吧 !😱

MCP 来了!一个协议解决所有问题!

MCP 协议就是为了解决这个问题而生的!它让开发人员能够在数据源和 AI 工具之间建立 安全的双向连接 。

架构超简单:开发者通过 MCP 服务器公开数据,然后构建连接到这些服务器的 AI 应用程序(MCP 客户端)。

也就是说, 你只需要按照 MCP 这个标准协议来集成 AI 和数据源 ,而不用为每个数据源、每个 AI 助手单独开发连接器了!这也太方便了吧!🎉

Apifox MCP Server 来了!让 AI 秒懂你的 API 文档!

现在,越来越多的 AI 工具已经内置了 MCP 客户端,比如 Cursor、Cline、Claude Desktop 和 Cherry Studio,它们都能连接到 MCP 服务器。

Apifox 作为 API 设计、开发、测试一体化协作平台,也看到了 MCP 在 API 开发中的巨大价值。所以...

Apifox MCP Server 内测开启啦!!! 🎉🎉🎉

使用 Apifox MCP Server ,你可以 把 Apifox 项目里的接口文档作为数据源提供给支持 AI 编程的 IDE 工具 (比如 Cursor),这样 AI 就能直接访问你的接口文档数据了!

想象一下,你可以让 AI 帮你:

  • 根据接口文档生成或修改代码

  • 搜索接口文档内容

  • 还有更多更多可能性...

怎么用?超简单!

安装配置好 MCP 后,Apifox MCP Server 会自动读取整个项目的所有接口文档并缓存在本地。AI 就能通过 MCP 读取所有接口文档数据了。

你只需要告诉 AI 你想干啥就行了,比如:

  1. "通过 MCP 获取 API 文档,然后生成 Product 及其相关模型的定义代码"

  2. "根据 API 文档,在 Product DTO 里添加 API 文档新增的几个字段"

  3. "根据 API 文档给 Product 类的每个字段都加上注释"

  4. "根据 API 文档,生成接口 /users 相关的所有 MVC 代码"

小提示 :接口文档数据会缓存在本地,如果 Apifox 内的数据有更新,记得告诉 AI 刷新接口文档数据,不然 AI 读到的可能不是最新的哦!

赶紧来试试吧!

这个功能现在还在 内测阶段 ,感兴趣的小伙伴们赶紧查看「Apifox MCP 文档」抢先体验吧!

MCP 生态正在飞速发展,我们正和开发者们一起探索 AI 和 API 协作的未来。这波操作,你觉得怎么样?欢迎在评论区分享你的想法!😄