Agent 宿主可能需要一个可配置的连接。应用程序开发者可能需要一个可导入代码的库。这些需求导向不同的集成方式。
它们各自向调用方提供什么?
MCP 服务器提供协议接口;SDK 提供编程语言的函数和类型。
MCP 架构指南描述了服务器如何向已连接的客户端暴露能力。服务器可以作为本地进程运行,也可以提供远程端点。
| 接口 | 调用方 | 调用方使用的内容 | 运行时责任 |
|---|---|---|---|
| MCP 服务器 | Agent 宿主或应用程序中的 MCP 客户端 | 协议请求和已发现的能力 | 由某方运行服务器进程或远程服务 |
| API SDK | 应用程序代码 | 调用 API 的库方法 | 应用程序运行该库并管理其集成 |
| MCP SDK | 实现 MCP 客户端或服务器的代码 | 协议类型和实现辅助工具 | 应用程序仍然运行生成的客户端或服务器 |
SDK 包不会仅因为安装就变成一个运行中的服务器。
服务器可以使用 SDK 吗?
可以。开发者可以使用协议 SDK 来实现 MCP 服务器,然后在其处理程序中使用另一个客户端库。
MCP SDK 文档描述了用于构建客户端和服务器的库。这里,SDK 指的是用于实现协议的代码。
API SDK 的目标不同:它调用服务的 API。假设一个订单服务器暴露了一个订单状态工具,其处理程序可以使用 API SDK 来检索订单。
外层 MCP 接口与内层 API 调用有各自独立的契约。支持某个 API 操作并不会自动将其暴露为 MCP 工具。
哪些职责仍然在我的应用程序中?
你的应用程序仍然决定请求哪些操作,也决定如何处理操作结果。
使用 API SDK 时,你的代码选择方法并提供参数。使用 MCP 时,宿主通过客户端将请求路由到服务器暴露的能力。
MCP 架构将宿主对模型上下文的使用置于协议范围之外。工具连接不决定你的业务规则、授权策略或完成条件。
对于订单查询,收到请求的状态可能就完成了任务。对于发送消息,提交和后续投递是两个独立的结果。
如何选择 Bird 集成方式?
你可以将兼容的 Agent 宿主连接到 Bird 的 MCP 服务器,或者通过 API 客户端集成应用程序代码。
对于库路线,Bird SDK 决策涵盖了 SDK 与直接 HTTP 之间的选择。对于工具路线,你的客户端的 Bird 清单提供可用的工具名称和输入模式。
在你打算使用的接口上比较所需的操作。一个操作存在于某个接口,并不意味着它也存在于另一个接口。
- 当你的宿主需要发现并调用 Bird 工具时,使用 MCP 连接。
- 当你的应用程序代码选择并调用服务操作时,使用 API 客户端。
- 当你在实现协议客户端或服务器本身时,使用 MCP SDK。