13 MCP 与外部能力
内置工具已经能处理一些常见动作。想连接一个外部资料系统时,还需要让应用知道怎样发现和调用它的能力。
MCP 为这类交互提供统一约定。本章使用只读的合成场地服务,观察“连接了一个程序”和“用它完成任务”之间的各个步骤。
13.1 应用 连接组件与服务
MCP 的 Host 是管理交互的应用,Client 是它与某个服务通信的组件,Server 提供工具、资源或提示词等能力。服务可以是本地程序,也可以在远端运行。
不要把 Server 这个词直接理解成一台远程电脑。一个通过标准输入输出通信的本地进程,也可以是 MCP 服务。协议负责交换约定,不代替模型决策与宿主任务管理。架构参考
13.2 三类能力分别做什么
| 类型 | 课程服务提供什么 | 使用时关注什么 |
|---|---|---|
| 工具 | lookup_venue,查询一个场地 | 输入 room、实际返回、版本与失败情况 |
| 资源 | venue://catalog,静态合成目录 | 读取的是内容,不自动执行查询或修改 |
| 提示词 | review_venue,场地审阅模板 | 人选择并填写参数后,模板进入交互 |
工具说明可以让模型决定调用什么,资源提供背景,提示词帮助组织一次输入。Skill 还可以保存完整工作方法与配套文件,它们的用途有交集但不是同一个机制。
13.3 课程只读服务的准备
练习包 tools/venue_server.py 使用官方 Python SDK v2。源码里只有 301、201 和 B205 的合成场地信息,不读取私人文件、不改变记录,也不开放 HTTP 端口。
教师应先准备 Python 3.11 以上和 uv,阅读源码。按当期官方 SDK 文档安装或使用临时隔离环境,不改常用业务环境。SDK 入门
在本地 stdio 配置中,命令为 uv,参数依次是:
run
--no-project
--with
mcp[cli]>=2,<3
mcp
run
/你的课程素材绝对路径/tools/venue_server.py
--transport
stdio路径需要替换成你的实际文件位置。首次执行可能获取官方 SDK 依赖,应在课堂前完成准备。若当前平台的 SDK 或入口不同,依据官方文档适配,不把这份示例当成所有版本的固定命令。
实验 E30 从连接走到查询
操作步骤
- 阅读课程服务源码,确认数据范围与只读行为。
- 在 Cherry Studio 的 MCP 设置中添加本地 stdio 服务,填写命令与路径。
- 启动并查看实际暴露的工具说明,不只看状态图标。
- 将服务绑定给专用 Agent;查看当前任务是否可发现 lookup_venue。
- 查询 room 为 301,再查询 999,分别记录实际结果。
- 回到当前活动说明,核对版本与容量,不把 201 的旧版数字当成现行安排。
请使用课程场地查询工具查 301 的容量和版本。
再查询 999。没有找到时保留未知,不补写场地。
只做查询,不尝试预约、写入或连接其他业务系统。完成标准
记录连接、发现、绑定和查询四个状态。查询返回 found:false 是“没找到资料”的结果,不一定代表协议或连接失败。
参考解释
301 对应容量 30、community-v2。999 不在合成目录中,应保持未找到。查询结果还要与本任务采用的版本对应,不能只因工具调用成功就采用所有返回内容。
实验 E31 读取资源与使用模板
操作步骤
- 在当前服务提供的资源中读取 venue://catalog,确认数据和版本。
- 选择 review_venue 提示词,填写活动名和 room,观察进入输入区的内容。
- 使用实际查询工具,比较工具返回与静态资源、模板文本的不同作用。
- 让已启用活动审阅 Skill 的 Agent 使用场地查询,再按技能生成报告。
- 如果宿主没有显示某类入口,记录支持限制,不用手工粘贴的内容冒充原生资源读取。
完成标准
能指出哪个载体提供资料、哪个组织输入、哪个执行动作、哪个规定工作方法。
参考解释
模板函数可生成一条供用户使用的消息,但没有自动完成查询。实际工具或资源使用需要相应协议交互。技能可规定先查版本再写报告,仍依赖可用能力。
13.4 连接范围仍然需要管理
课程服务是合成只读示例。连接真实系统时,应明确资料范围、凭据和允许动作。MCP 并不会让所有外部动作天然可靠,也不会替用户决定授权。
实测:连接、绑定、调用和插入分别确认
本机使用课程包的只读 venue_server.py,通过 stdio 连接。设置页显示“已连接”,并列出 1 个工具、1 个提示、1 个资源;随后在课程 Agent 的 MCP 标签页单独启用该服务器。
实际调用 lookup_venue 两次:room=301 返回 found=true、容量 30、community-v2;room=999 返回 found=false、venue=null。两次调用均有卡片,并能展开参数与 JSON 返回。
让 Agent 自行获取 review_venue 时,它报告没有提示词获取入口。但在输入快捷面板选择“MCP 提示词”,能找到同一模板,填入 activity 和 room 后,宿主将模板正文插入输入框。此处没有发送这段模板,也没有把“插入成功”写成“模板任务执行完成”。
同样通过“MCP 资源”选择 venue_catalog,能取回带 synthetic=true 的三条场地目录并插入输入框。这说明本轮宿主提供了资源与模板入口,不能仅从模型说“没有入口”就推断整个产品都不支持。
自检题
01MCP 是否就是一种模型?
不是。它定义应用与服务交换能力和上下文的协议。模型如何生成、宿主怎样管理任务并不由 MCP 完整决定。
02服务器已连接,为什么 Agent 仍可能不能使用?
还要检查服务实际暴露的能力、当前 Agent 绑定、运行状态、参数和权限。连接成功与一次实际调用成功分别记录。
03工具、资源和提示词有什么区别?
工具提供可执行动作,资源提供可读取内容,提示词提供可选交互模板。不同服务不一定提供全部类型,模板也不自动等同于完整 Skill。
04本地 MCP 服务是否一定读取本地私人文件?
不一定。执行位置和访问范围要分别看实现。课程服务只返回源码中的合成数据,不读取私人文件,也不因为本地运行就自动获得全部权限。
下一章讨论长任务、上下文与记忆,理解多步执行怎样保存信息和接续工作。
本章资料:MCP 架构、Cherry Studio 外部工具、SDK 工具与模板。具体协议和宿主支持需要按当期版本确认。




