Files
Agent-Workbench/docs/MCP.md
2026-11-07 10:51:42 +08:00

40 lines
4.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 项目所属 MCP 工具
当前源码支持项目登记的本地 stdio MCP,使用固定协议 `2025-03-26`。M1 已补齐开放模式完整记录、分页和原始 JSON Schema;这批源码尚未发行或部署。正式版本与各轮证据分别见[完整记录验收](QA-M1-OPEN-RECORDS.md)和[Schema 验收](QA-M1-MCP-SCHEMA.md),历史 1.12 的有界设计不再代表默认开放模式。
## 使用流程
1. 从工作台工具菜单打开「项目 MCP 工具」,登记程序绝对路径。脚本入口使用当前宿主 Node.js,接受 `.js`、`.mjs`、`.cjs`;登记后保持停用,不自动安装或执行 shell 字符串。
2. 点击「实际探测」并核对启动对象。工作台实际启动所属进程,执行 `initialize` 和完整分页 `tools/list`,保存服务版本、工具原声明、请求轨迹和关闭结果。
3. 查看用途与原始参数契约,选择允许模型请求的工具并保存启用。Annotations 是服务器数据,不构成用户授权。程序或契约变化时可立即停用;界面区分「尚未核验」和「实际没有工具」。
4. 模型按本轮实际目录的注册 ID、配置修订、契约 SHA 和工具名调用。调用使用用户持久保存的 `ask/auto/full` 权限:ask 请求批准,auto 按现有批准策略处理,full 直接执行并保留自动批准审计,不额外要求模型追问确认。
5. 在所属任务的「MCP 运行记录」分页查看原输入和原报告,或下载显示的原件。显示批次不限制总记录数;完整计数与预览分别标明。
## 原始 Schema 与参数
MCP 2025-03-26 要求 `inputSchema` 的根为 `type: "object"`,`tools/call.arguments` 为对象。工作台只核对这些协议外层格式;具体 JSON Schema 语义由声明工具的服务器校验。官方职责与冻结来源见[本批计划](M1-MCP-SCHEMA-PLAN.md)。
完整保留联合类型、递归或外部引用、嵌套、布尔子 schema、pattern、条件、方言及扩展字段。工作台不自动获取 `$ref`,不把未知关键字当作不支持,不转换类型、补默认值或删除额外参数,也不宣称已在本地验证全部 schema 语义。协议根格式无效的工具保留原声明但不能启用。
新 v2 契约另存完整 `rawTools`,包括 annotations 与其他原始字段;模型目录保持原始 `inputSchema`。旧 v1 工件不改字节或 SHA,只按当前协议重新投影旧的客户端 `unsupported` 标签,用户仍需明确选择工具。实际再次握手的服务版本及原声明变化仍会在 `tools/call` 前报错,不把客户端分类修正误当服务器漂移。
服务器的 `CallToolResult.isError` 保持失败;JSON-RPC 错误保留原 code、message 和 data(经过现有凭据脱敏),不重试。JSON-RPC 拒绝并不能单独证明外部没有副作用,已发送但没有完整工具结果的调用仍按现有合同保留 unknown。
## 执行模式、身份和进程
默认 `unrestricted/passthrough/preserve` 不设登记、发现分页、启用工具、目录字节、参数字节、结果帧、任务操作总数或请求等待的本地额度。显式手动限制模式沿用原限制并明确显示;登记中的 500–45000ms 旧配置只作用于该模式,开放调用实际超时为 0。服务器自身规格与原报错按实际结果记录。
程序与可选入口保存真实路径、大小和 SHA。探测、启用及调用前重新核对;每次调用再次握手并核对冻结契约。核对范围为程序/入口与握手声明,依赖文件没有全量封存,不能据此声称整个第三方安装包被认证。
每个操作使用独立临时目录与所属 stdio 连接,仅继承必要系统环境;模型 Key 不传入。服务端 sampling、roots、elicitation 等请求不获得宿主权限。独立进程以当前系统用户身份运行,不是 OS 沙箱。
## 停止、恢复与证据
输入、目录、报告绑定项目、会话、Task 和 Run,并经现有 Provider 脱敏。报告保留真实握手、原工具声明、返回内容、错误、请求轨迹、stderr 预览与所属进程关闭观察;外部输出不能替代本项目工程验收。
停止会传播取消并关闭本次拥有的进程。已发送但结果不完整、或无法确认关闭时保留 unknown;重启不自动重放,也不按历史 PID 停止其他进程。人工核对绑定原输入/报告指纹,另存审核记录,保留原未知状态;保存失败恢复内存状态。未知副作用按现有合同暂停后续外部执行,核对后显式续接。
## 验证边界
本批使用自有本地 MCP 程序、本机 HTTP 模型夹具、独立编译宿主和实际 Electron,验证大 schema、14 项工具、2100 条参数、旧 SHA、原错误、漂移与网页/桌面宽窄屏。它不证明真实第三方工具业务正确、全球模型兼容、远程 HTTP MCP、插件自动安装、缓存不掉或 Purge 收益。最新完整结果、首失败和未尽事项均见[验收与回顾](QA-M1-MCP-SCHEMA.md)。