FastMCP 4.2 与 Skills over MCP:Agent 接入前要确认什么
11 月 13 日发布的 FastMCP 4.2.0增加了服务器侧的 Agent Skills 目录。团队可以把技能与它描述的工具一起维护,由客户端从服务器读取,减少逐机分发文件夹的工作。变化集中在分发方式;是否加载和执行这些指令,仍由宿主决定。
该版本实现了实验性的 Skills over MCP 扩展,对应 SEP-2640。FastMCP 4.2.0 是框架版本,io.modelcontextprotocol/skills 是扩展标识,MCP 协议修订版又是另一层选择。升级其中一层,不代表其余层已支持。以下按 2026 年 11 月 17 日核对的发行说明与规范解释,不声称在 IDE 或聊天宿主完成端到端实测。
实际传递了什么?
技能由指令和辅助文件组成。MCP 工具描述可调用的操作,技能则可以解释 Agent 应在何时、以何种步骤组合这些操作。提供指令文件本身不会授予工具权限,也不会让宿主自动执行。
| 层次 | 提供的能力 | 仍需确认的条件 |
|---|---|---|
FastMCP Skill 与 SkillCatalogProvider | 加载编写好的技能,与服务器工具一起暴露目录 | 准备公开哪些目录和文件,谁有权读取 |
skills/list、skills/get | 支持扩展的客户端发现技能并读取清单 | 客户端与服务器均协商扩展,区分部分实现 |
resources/read | 读取指令和辅助文件内容 | 文件可读,大小与摘要一致 |
Client.read_skill()、to_directory() | 验证读取到的技能并导出到本地目录 | 各宿主自己的本地安装、审阅与执行策略 |
发行说明还为不支持扩展发现的客户端提供普通资源读取。因此,resources/read 成功能证明文件可访问,但不能证明 skills/list、自动发现、本地安装或执行已支持。
采用 4.2 前的检查
先检查 Python: FastMCP 4.2 要求 Python ≥3.11。在独立测试环境固定 fastmcp==4.2.0,使核对的 API 与运行的 API 一致。试用这一功能不需要替换宿主原有的 MCP SDK 环境。
发行说明使用以下导入与调用构建技能目录:
from fastmcp import FastMCP, Skill
from fastmcp.skills.provider import SkillCatalogProvider
skill = Skill.from_directory("skills/deploy")
mcp = FastMCP("Team Skills")
mcp.add_provider(SkillCatalogProvider([skill]))这段代码是服务器的注册部分,不是完整启动示例。skills/deploy 必须已有你编写的技能,公开前应检查其中所有文件。运行与迁移细节参考 Skills 服务端文档;该文档滚动更新,采用时仍需对照已安装版本。
4.1 Skills API 已弃用,计划在 4.3 移除。 应迁移 fastmcp.server.providers.skills 中的旧 provider 和 fastmcp.utilities.skills 中的 helper。Skill 现在是编写技能时使用的对象,wire model 改名为 MCPSkill。不能因旧别名暂时还能导入,就把 4.1 示例当成已经完成 4.2 迁移。
验证真正需要的客户端能力
先查看扩展支持矩阵,再核对实际部署的宿主版本文档。“部分支持”应继续读取其链接的实现说明。矩阵由上游维护,不保证某个产品所有版本具有同一套技能生命周期。
| 检查 | 应取得的结果 | 不足以证明通过的结果 |
|---|---|---|
| 发现 | 双方声明扩展,列表包含预期技能 | 服务器启动没有报错 |
| 获取 | 读到清单及每个预期文件 | 只读到一份指令文件 |
| 校验 | 确认字节大小与 SHA-256 摘要,错误时拒绝 | CLI 退出成功,但没看报告 |
| 宿主采用 | 确认宿主如何加载、更新、批准和使用技能 | 成功导出一个本地文件夹 |
Inspector可帮助区分协议检查与宿主行为。Inspector 2.15.0 的已发布 CLI 包含在 @modelcontextprotocol/inspector 总包中,不要假定 workspace 中的 CLI 包单独发布。Skills 校验使用 --verify 配合 --method skills/list 或 skills/get。直接指定 stdio 目标时应选择 --protocol-era modern,不能依赖默认 legacy 模式。具体调用和 Node 要求查该版本的固定 CLI 源码。
同时读取报告与退出码:0 可能表示校验通过,也可能表示动态内容无法验证;7 表示不合规,例如大小、摘要不符或文件不可读;8 表示在预算内未完成校验;9 表示要求摘要时遇到无法验证的内容。这些是已发布 CLI 的语义,不是本文新跑出的结果。CLI 校验不能证明某个宿主会执行远程技能。
完整性与可信度分别判断
SHA-256 匹配说明取回的字节与声明摘要一致,不能说明发布者可信,也不能说明遵循这些指令适合当前任务。应审阅指令变更、只公开预期文件、保留服务器鉴权规则,让宿主继续执行用户确认和工具最小权限策略。导出技能不应绕过已有的本地审阅步骤。
依赖目录前先覆盖失败情况:文件缺失、字节大小错误、摘要错误、内容动态变化和不安全导出路径。确认错误能被清晰拒绝,修正技能后能正常重试。协议层测试不能写成跨宿主兼容结论。
WebMCP 适用于什么问题?
如果目标是让 Agent 使用浏览器产品中的操作,可以继续看 WebMCP 中文指南与英文指南。浏览器集成有自己的 API 与生命周期;能发现远程 MCP 技能不表示支持 WebMCP,实现 WebMCP 也不表示支持 Skills 扩展。
协议合同见 Skills 规范,服务器可调用操作见工具规范。若还使用官方 Filesystem、Git 或 Fetch 参考服务器,接入真实数据前另行检查 11 月安全更新。