跳到主要内容
← 返回AI Agent Engineering|12 周从 Demo 到真实 Agent 系统

AI Agent Engineering · Week 04

04-02|MCP:把外部能力标准化给 AI 使用

理解 MCP Host、Client、Server、Tool 与 Resource 的关系,以及标准化发现和调用解决了哪一层连接问题。

MCP · Protocol · Integration

当第二个 AI 应用也要查询订单

V0.3 的订单 Tool 直接注册在当前 Agent Runtime 内。如果客服工作台、IDE Agent 和内部运营助手都要使用这项能力,每个应用分别实现发现、参数描述、连接和结果解析,会产生多套重复集成。

MCP 提供一套 AI 应用与外部能力、上下文交换的标准协议。它定义 Host 如何连接 Server、发现能力并发起调用。它不规定模型怎样推理,也不替业务系统保存订单。

Host、Client 与 Server

MCP Host
客服 AI 应用:管理模型、权限体验与多个连接
↓ 为每个 Server 创建专用 Client
MCP Client A
连接订单 Server
MCP Client B
连接知识 Server
↓ discovery / list / call / result
Order MCP Server
Knowledge MCP Server
图 1|Host 管理 AI 应用;Client 维护一条连接;Server 暴露标准化能力和上下文。

Host 是用户正在使用的 AI 应用。Client 是 Host 内连接某个 Server 的协议组件。Server 可以在本机通过 stdio 运行,也可以通过 Streamable HTTP 远程提供服务;“Server”描述角色,不等于一定是一台远程机器。

Tool、Resource 与 Prompt

Tool

可调用的查询或动作,例如 get_order_summary。

模型可建议调用,Host/Runtime 决定是否执行。
Resource

可读取的上下文数据,例如公开的字段说明或政策版本。

由应用选择何时读取和放入 Context。
Prompt

可复用的交互模板。

适合用户或应用选择的任务入口,不是业务权限。
图 2|三种 primitive 的控制方式不同;不要把任何一种当作数据库或授权系统。

Server 通过发现机制告诉 Client 自己支持哪些能力。Client 可以列出 Tools,再按 Schema 发起 tools/call。标准化的是发现、描述、调用和返回的协议形状,不是背后的业务实现。

MCP 与业务 API 的关系

AI Host
↓ MCP
Order MCP Server
↓ Provider Adapter
Shopify / ERP API
↓
Order Database

图 3|MCP 可以包装 API;订单 API 与数据库仍负责真实数据、认证和业务约束。

MCP 不自动授予订单访问权。远程连接仍要认证;Server handler 仍要按可信身份做授权;Tool Result 仍要校验和脱敏。一个声明为只读的 Tool 也不能只靠描述保证安全,执行层必须真正限制副作用。

当前规范与长期概念

长期稳定的是 Host / Client / Server 分层、能力发现与结构化调用。到 2026-10-18,官方文档当前使用 2026-07-28 规范;TypeScript SDK v2 是稳定线,包拆分为 @modelcontextprotocol/server 与 @modelcontextprotocol/client。这些包名和具体方法属于当前实现,后续可能继续演化。

Failure Lab

“用了 MCP,就不用写 API 集成”

为什么诱人: MCP Server 看起来已经提供统一接口。

为什么失败: Server 内仍要调用 Shopify、ERP 或数据库,并处理供应商认证、字段与限流。

更合理设计: MCP 负责 AI 连接层;Provider Adapter 继续负责业务 API 集成。

把每条订单都暴露成 Resource

为什么诱人: Host 可以随时读取,似乎很方便。

为什么失败: 资源枚举与缓存可能扩大敏感数据暴露,权限边界也更难审计。

更合理设计: 敏感业务查询优先使用受控 Tool,并按请求身份返回最小结果。

相信 Tool 描述能阻止越权

为什么诱人: 描述里已经写了“只查当前客户”。

为什么失败: 描述影响模型选择,不构成服务端强制规则。

更合理设计: Server 从认证上下文取得身份,handler 每次执行授权检查。

实践:给 V0.3 画 MCP 边界

标出 Host、Client、Order MCP Server、Provider Adapter 和订单 API。为 get_order_summary 写出发现信息、模型参数、可信身份来源、业务响应和失败出口。

Acceptance Criteria

  • ☐ Host、Client 与 Server 没有混用。
  • ☐ Tool、Resource、Prompt 的控制方式和用途清楚。
  • ☐ MCP Server 背后仍保留 Provider Adapter 与业务 API。
  • ☐ 可信身份不由模型参数提供。
  • ☐ 本地 stdio 与远程 HTTP 只是传输选择,不改变业务权限。
  • ☐ 当前 SDK 实现与长期协议概念明确分开。

主动回忆

  1. 一个 Host 连接两个 Server 时会有几个 Client?
  2. MCP 标准化了哪一层,又没有标准化哪一层?
  3. 为什么敏感订单查询更适合 Tool 而非批量 Resource?
  4. Tool 描述为什么不能承担 Authorization?

下一课比较直接 API 与 MCP 的决策成本:哪些场景多一层协议能带来复用,哪些场景只会增加运维负担。

延伸阅读 / Sources

核查日期:2026-10-18。

长期有效的原理: 能力发现、协议边界、最小权限与服务端授权。当前实现方式: 协议版本、SDK 包、transport API 和扩展会变化,编码前必须重新核对官方版本与迁移说明。