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 传输不能简单混称为一回事。选型与迁移要看客户端实际支持。传输规范
一个调用应经过哪些边界
- 应用确认当前任务需要哪些工具,向模型提供可用定义。
- 模型提出调用,应用检查工具名、参数、用户身份和资源范围。
- Client 发送请求,Server 再做输入与业务权限检查。
- 结果返回后控制体积,保留来源、截断标记和错误类型。
- 应用把结果作为数据提供给模型,并检查最终产物。
工具声明“只读”可以帮助宿主理解能力,真正的限制仍需在服务端实现。访问令牌、租户信息和数据库账号不能依靠提示词隔离。
设计工具时先收敛能力
将 execute_anything(command) 收敛为 find_note(query)、get_note(note_id) 等可描述的领域操作。定义短而清楚的字段,返回稳定的结构化结果;把未找到、参数错误、上游不可用区分开。
下一步:动手写 MCP Server。运行模式、SDK 版本和本地客户端验收步骤都放在实验页。