跳到主要内容

MCP:连接工具、资源与提示模板

MCP(Model Context Protocol)为 AI 应用与外部能力之间提供共同协议。它关注连接与交互方式;应用仍然要决定何时使用工具、当前用户是否有权限,以及结果能否进入后续上下文。

先认清三个角色​

Host 管理用户交互和模型使用;Client 与 Server 建立协议连接;Server 暴露特定领域的能力。不同版本的协议细节会变化,接入前应确认双方的协议与能力支持。官方架构说明

三种常见能力​

能力适合表达教学示例
Tools由应用调用的操作find_note(query) 搜索笔记
Resources可读取的内容note://agent-intro 文档内容
Prompts可复用的交互模板生成带引用的笔记摘要模板

工具返回值也有来源与信任等级。搜索结果里出现的指令仍然是外部内容,不应获得与用户授权相同的效力。

stdio 与 Streamable HTTP​

以下按 2025-11-25 版传输规范解释,避免将某个版本的生命周期假定为所有实现通用。

方式典型场景常见错误
stdio本地 Host 启动子进程在 stdout 打印普通日志,破坏协议消息
Streamable HTTP通过 HTTP 提供远程服务未校验来源、身份或暴露范围

stdio 的普通诊断日志应写 stderr;Streamable HTTP 与旧版 HTTP+SSE 传输不能简单混称为一回事。选型与迁移要看客户端实际支持。传输规范

一个调用应经过哪些边界​

  1. 应用确认当前任务需要哪些工具,向模型提供可用定义。
  2. 模型提出调用,应用检查工具名、参数、用户身份和资源范围。
  3. Client 发送请求,Server 再做输入与业务权限检查。
  4. 结果返回后控制体积,保留来源、截断标记和错误类型。
  5. 应用把结果作为数据提供给模型,并检查最终产物。

工具声明“只读”可以帮助宿主理解能力,真正的限制仍需在服务端实现。访问令牌、租户信息和数据库账号不能依靠提示词隔离。

设计工具时先收敛能力​

将 execute_anything(command) 收敛为 find_note(query)、get_note(note_id) 等可描述的领域操作。定义短而清楚的字段,返回稳定的结构化结果;把未找到、参数错误、上游不可用区分开。

下一步:动手写 MCP Server。运行模式、SDK 版本和本地客户端验收步骤都放在实验页。