如果你关注着 AI 的发展,那么最近可能经常看到 MCP 这个词。
MCP 即模型上下文协议(Model Context Protocol)的缩写,于 2024 年 11 月由 Claude 大模型的公司 Anthropic 推出并开源。这是一个将 AI 助手连接到第三方数据源的新标准,包括内容存储库、业务工具和开发环境。它的目的是帮助 AI 大模型生成更好、更相关的回答。
AI 模型的“信息孤岛”问题
随着 AI 大模型获得了广泛的使用,该行业在训练模型方面投入了大量资金,新的模型在推理能力和生成质量方面得到了较大的进步。
但是,训练 AI 的数据集始终是滞后的、固定的,再强大的 AI 也只是知道过去发生的事情,却无法实时从外界获取最新的信息,比如今天的天气情况、今天的热点新闻等。
联网搜索:第一代解决方案
为了解决这个问题,常见的 AI 助手通过 AI 代理模式,设计了联网搜索的工作流。
当用户和 AI 助手对话,且开启联网搜索后,AI 助手会先将用户说的话发送给第三方搜索引擎,然后将第三方搜索引擎的返回的内容和用户说的话一起提供给 AI 大模型,再由 AI 大模型生成回答。可以看出,搜索引擎在这里充当了第三方实时信息源的角色,为 AI 大模型提供了额外的上下文信息。

自有系统数据:超越公共搜索的需求
对于搜索引擎能搜索到的、有多种信息源的公开信息,AI 助理的这种联网搜索功能效果不错。
但是,如果希望 AI 能提供行业内部信息、或者你研发的自有系统内的信息,AI 联网搜索的效果就很不好,甚至无法实现。举个简单的例子,问开启了联网搜索的 DeepSeek 这个问题:Apifox 的最新版本是多少?DeepSeek 的回答是 2.6.41。但实际上,Apifox 的最新版已经到了 2.7.2,差了 10 个版本。

为了让自有系统和 AI 模型紧密协作,打破信息隔离,用户可以自行搭建 AI 代理,将自有系统的数据通过 API 的形式接入 AI 助手。继续上面的例子,我们可以将 Apifox 的更新日志内的信息,通过 API 向外提供。然后设定这样一个工作流:如果有人问 Apifox 的最新版本是多少,则调用这个 API,再将 API 返回的结果和用户的原始问题一起提供给 AI,这样 AI 就可以给出正确的回答了。

MCP:构建统一的模型上下文连接标准
以上只是一个非常简单的场景,在真实业务环境中,需要将多种数据源接入AI大模型,也就必须得为不同的数据源、不同的 AI 助手开发不同的连接器。虽然可以使用第三方 AI 代理工具或知识库工具,但仍然无法避免架构碎片化的问题。
MCP 协议正是为了解决数据连接器集成碎片化的问题而生。它使开发人员能够在其数据源和 AI 驱动的工具之间建立安全的双向连接。架构简单明了:开发人员可以通过 MCP 服务器(MCP Server)公开他们的数据,也可以构建连接到这些服务器的 AI 应用程序(MCP 客户端,MCP Client)。
也就是说,开发者现在可以根据 MCP 这个标准协议来完成 AI 大模型与数据源的集成,而不是为每个数据源、每个 AI 助手维护单独的连接器。随着 MCP 生态系统的成熟,人工智能系统将在不同的工具和数据集之间移动时保持上下文,用更可持续的架构取代当今的零散集成。

Apifox MCP Server:API 开发的智能助手
现在,越来越多的 AI 工具已经内置了 MCP 客户端,比如 Cursor、VSCode + Cline、Claude Desktop 和 Cherry Studio,它们都已经具备连接到 MCP 服务器的能力。
Apifox 作为 API 设计、开发、测试一体化协作平台,已经观察到了 MCP 在 API 开发工作流中的价值。使用 Apifox MCP Server,可以将 Apifox 项目内的 API 文档作为数据源提供给 Cursor 等支持 AI 编程的 IDE 工具,以便让 AI 能够直接访问项目对应的 API 文档数据。
Apifox MCP 能做什么
根据 API 文档,生成数据模型代码
例如:通过 MCP 获取 API 文档,然后生成 Pet 及其相关模型的定义代码

修改 API 文档后,为数据模型代码添加新增的字段
例如:重新读取 API 文档数据,在 Pet DTO 里添加 API 文档新增的几个字段

根据 API 文档,生成接口的 MVC 代码
例如:根据 API 文档,生成接口 /pet
相关的所有 MVC 代码

其他场景
请发挥你和你们团队的想象力...
如何配置 Apifox MCP Server
Apifox MCP Server 支持以下三种不同的使用场景,可以根据不同场景选择下文对应的配置方法。
无论你使用的是 Cursor、VSCode + Cline 还是其它支持 MCP 的 IDE,只需简单配置,AI 即可直接读取 API 定义,生成规范代码,提升开发体验。
1. 使用公开发布的 Apifox 在线文档
适用场景 | • 使用 AI 读取别人公开发布的 API 文档 • 让自己团队外的开发者,即 API 的调用方,通过 AI 读取自己团队公开发布的 API 文档 |
特点 | • 无需 Apifox 个人访问令牌 • 仅支持公开发布的文档,不支持设置了密码、白名单的文档 • 对于自己团队的非公开文档,建议使用项目 ID 和个人访问令牌读取 Apifox 项目数据 |
具体配置方法,请查看:通过 MCP 使用公开发布的在线文档
2. 使用 Apifox 项目数据
适用场景 | 使用 AI 读取自己团队的 API 文档 |
特点 | 需要 Apifox 个人访问令牌 |
具体配置方法,请查看:通过 MCP 使用项目内文档。
3. 使用 Swagger/OpenAPI 文件
适用场景 | 使用 AI 读取本地或线上的 Swagger/OpenAPI 文件 |
特点 | • 不依赖 Apifox 项目或在线文档 • 无需 Apifox 个人访问令牌 |
具体配置方法,请查看:通过 MCP 使用 OpenAPI 文件
结语:MCP 的未来展望
MCP 协议代表了 AI 工具生态系统的重要发展方向 - 从孤立的封闭系统转向开放互联的协作网络。通过 MCP,AI 模型不再仅限于训练数据的范围,而是能够实时连接到各种专业数据源,从而提供更准确、更有价值的辅助。
特别是在软件开发领域,Apifox MCP Server 等工具的出现,让 AI 编程助手能够真正理解项目的技术细节和领域知识,从而提供更加精准的代码建议和问题解决方案。随着越来越多的工具加入 MCP 生态系统,我们有理由相信,AI 辅助开发的体验和效果将会得到显著提升。
无论你是开发者、产品经理,还是技术决策者,了解并应用 MCP 协议,都将帮助你更好地利用 AI 工具提升工作效率和创新能力。