Skip to content

13 MCP 与外部能力 ​

内置工具已经能处理一些常见动作。想连接一个外部资料系统时,还需要让应用知道怎样发现和调用它的能力。

MCP 为这类交互提供统一约定。本章使用只读的合成场地服务,观察“连接了一个程序”和“用它完成任务”之间的各个步骤。

13.1 应用 连接组件与服务 ​

MCP 的 Host 是管理交互的应用,Client 是它与某个服务通信的组件,Server 提供工具、资源或提示词等能力。服务可以是本地程序,也可以在远端运行。

外部能力怎样通过 MCP 接入
外部能力怎样通过 MCP 接入应用通过 MCP 连接组件访问服务;服务提供的工具、资源和提示词各有职责,权限仍由环境控制。 AI 应用组织模型与任务管理可用能力MCP 连接组件连接与发现能力传递协议消息MCP 服务本地或远程程序处理相应请求工具与资料返回动作、资源或模板进入任务工作环境连接约定与任务分工
应用通过 MCP 连接组件访问服务;服务提供的工具、资源和提示词各有职责,权限仍由环境控制。查看原图 →

不要把 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,参数依次是:

text
run
--no-project
--with
mcp[cli]>=2,<3
mcp
run
/你的课程素材绝对路径/tools/venue_server.py
--transport
stdio

路径需要替换成你的实际文件位置。首次执行可能获取官方 SDK 依赖,应在课堂前完成准备。若当前平台的 SDK 或入口不同,依据官方文档适配,不把这份示例当成所有版本的固定命令。

实验 E30 从连接走到查询 ​

操作步骤 ​

  1. 阅读课程服务源码,确认数据范围与只读行为。
  2. 在 Cherry Studio 的 MCP 设置中添加本地 stdio 服务,填写命令与路径。
  3. 启动并查看实际暴露的工具说明,不只看状态图标。
  4. 将服务绑定给专用 Agent;查看当前任务是否可发现 lookup_venue。
  5. 查询 room 为 301,再查询 999,分别记录实际结果。
  6. 回到当前活动说明,核对版本与容量,不把 201 的旧版数字当成现行安排。
text
请使用课程场地查询工具查 301 的容量和版本。
再查询 999。没有找到时保留未知,不补写场地。
只做查询,不尝试预约、写入或连接其他业务系统。

完成标准 ​

记录连接、发现、绑定和查询四个状态。查询返回 found:false 是“没找到资料”的结果,不一定代表协议或连接失败。

参考解释

301 对应容量 30、community-v2。999 不在合成目录中,应保持未找到。查询结果还要与本任务采用的版本对应,不能只因工具调用成功就采用所有返回内容。

实验 E31 读取资源与使用模板 ​

操作步骤 ​

  1. 在当前服务提供的资源中读取 venue://catalog,确认数据和版本。
  2. 选择 review_venue 提示词,填写活动名和 room,观察进入输入区的内容。
  3. 使用实际查询工具,比较工具返回与静态资源、模板文本的不同作用。
  4. 让已启用活动审阅 Skill 的 Agent 使用场地查询,再按技能生成报告。
  5. 如果宿主没有显示某类入口,记录支持限制,不用手工粘贴的内容冒充原生资源读取。

完成标准 ​

能指出哪个载体提供资料、哪个组织输入、哪个执行动作、哪个规定工作方法。

参考解释

模板函数可生成一条供用户使用的消息,但没有自动完成查询。实际工具或资源使用需要相应协议交互。技能可规定先查版本再写报告,仍依赖可用能力。

13.4 连接范围仍然需要管理 ​

课程服务是合成只读示例。连接真实系统时,应明确资料范围、凭据和允许动作。MCP 并不会让所有外部动作天然可靠,也不会替用户决定授权。

实测:连接、绑定、调用和插入分别确认 ​

本机使用课程包的只读 venue_server.py,通过 stdio 连接。设置页显示“已连接”,并列出 1 个工具、1 个提示、1 个资源;随后在课程 Agent 的 MCP 标签页单独启用该服务器。

本地 MCP 服务连接成功并发现三类能力

已连接服务在课程 Agent 中的绑定开关

实际调用 lookup_venue 两次:room=301 返回 found=true、容量 30、community-v2;room=999 返回 found=false、venue=null。两次调用均有卡片,并能展开参数与 JSON 返回。

MCP 两次实际调用与 JSON 返回

让 Agent 自行获取 review_venue 时,它报告没有提示词获取入口。但在输入快捷面板选择“MCP 提示词”,能找到同一模板,填入 activity 和 room 后,宿主将模板正文插入输入框。此处没有发送这段模板,也没有把“插入成功”写成“模板任务执行完成”。

通过输入面板填参后实际插入的 MCP 提示词

同样通过“MCP 资源”选择 venue_catalog,能取回带 synthetic=true 的三条场地目录并插入输入框。这说明本轮宿主提供了资源与模板入口,不能仅从模型说“没有入口”就推断整个产品都不支持。

宿主取得并插入合成场地目录资源

自检题 ​

01MCP 是否就是一种模型?
参考答案

不是。它定义应用与服务交换能力和上下文的协议。模型如何生成、宿主怎样管理任务并不由 MCP 完整决定。

02服务器已连接,为什么 Agent 仍可能不能使用?
参考答案

还要检查服务实际暴露的能力、当前 Agent 绑定、运行状态、参数和权限。连接成功与一次实际调用成功分别记录。

03工具、资源和提示词有什么区别?
参考答案

工具提供可执行动作,资源提供可读取内容,提示词提供可选交互模板。不同服务不一定提供全部类型,模板也不自动等同于完整 Skill。

04本地 MCP 服务是否一定读取本地私人文件?
参考答案

不一定。执行位置和访问范围要分别看实现。课程服务只返回源码中的合成数据,不读取私人文件,也不因为本地运行就自动获得全部权限。

下一章讨论长任务、上下文与记忆,理解多步执行怎样保存信息和接续工作。

本章资料:MCP 架构、Cherry Studio 外部工具、SDK 工具与模板。具体协议和宿主支持需要按当期版本确认。

微信联系

李不凯的个人微信二维码,扫码添加好友

使用微信扫一扫,手机上可长按保存二维码