Files
Agent-Workbench/docs/MCP.md
T
2026-10-30 20:59:18 +08:00

3.9 KiB

项目所属 MCP 工具

1.12可以按项目登记本地 stdio MCP 程序,探测真实工具目录,再让模型在明确审批后调用选定工具。探测通过、外部工具返回和工程交付分别判定。发行与部署状态见1.12验收。

使用流程

  1. 打开顶部「项目 MCP 工具」,填写程序绝对路径。脚本只接受当前宿主 Node.js 执行的 .js、.mjs、.cjs 入口,不接受 shell 命令、任意参数或自动安装。登记后保持停用。
  2. 点击「实际探测」,核对程序/入口和说明后确认。实际启动独立进程,执行 initialize 和 tools/list,记录协议、版本、schema、请求轨迹和关闭结果。
  3. 查看工具用途及参数契约,明确选择允许模型请求的工具,再保存并启用。服务的 annotations 不构成权限授予。
  4. 模型只能使用当前请求实际发送目录中的注册ID、配置修订、契约SHA256和工具名。每次调用仍显示独立审批,核对后才启动程序。
  5. 在所属任务「MCP 运行记录」查看原始输入、报告和状态;外部调用未收到结果时按未知处理,人工核对后才能继续涉及副作用的工作。

身份和进程

登记保存可执行文件、可选入口的实际路径、大小和SHA256。探测/启用/调用前重新计算;调用时再次握手并核对原服务版本和完整发现目录,漂移时拒绝发送 tools/call。SHA256范围为程序与入口;依赖文件没有全量封存。

每个操作使用独立临时工作目录和一条所属 stdio 连接。只继承 PATH、系统目录、临时目录等必要环境,模型Key及其他应用登录态不传入;服务发起的 sampling、roots、elicitation 等请求不获得宿主权限。独立进程不等于操作系统沙箱,程序仍以当前系统用户权限运行。

每次操作固定协议 2025-03-26,需要真实的工具能力声明。最多发现100项/4页、目录256KB、单帧1MB;单工具参数最多16000字节。参数校验只支持明确列出的有界JSON Schema子集,遇到 $ref、pattern 等未支持校验关键字时禁止启用该工具。

请求超时为500–45000毫秒,注册最多16项/项目、启用工具最多12项/注册、每轮目录最多12项、每任务最多30次操作。目录只使用剩余请求预算,不挤掉原目标或已保留代码。

原记录与恢复

输入、目录和报告工件均绑定项目、会话、Task和Run;报告包含真实握手、工具发现、返回内容、轨迹、stderr与所属进程关闭结果。完整数据经现有Provider脱敏,原外部数据不能自行授予权限或替代实际测试。

停止会传播取消并关闭本次拥有的进程。请求已发出但没有完整结果,或者进程关闭不能确认时,状态保留 unknown;宿主重开不会自动重放,也不会使用历史PID停止其他进程。人工核对另存审核记录,保留原未知状态和原报告,不把未知结果改成成功。

验证范围

专项使用自有本地MCP进程与HTTP模型夹具,验证实际stdio、审批、参数、配置漂移、凭据环境、取消/超时、原记录及项目隔离。桌面/390px另行检查实际页面。真实第三方服务、远程HTTP MCP、插件自动安装、第三方工程副作用和付费模型收益不从夹具结果推断为完成。

宿主中断且没有完整报告时,界面仍提供原始输入核验入口,不补造报告。人工核对绑定原输入/已有报告指纹和原工具调用,另存审核记录并同步工具与检查点待核对状态;保存失败恢复内存状态。未知副作用会阻止新任务、检查、变更应用、Git交付及其他外部执行,核对后显式续接。已变化的程序可以立即停用。

20项stdio/注册专项、6组管理界面和2组真实宿主中断界面通过;完整候选回归与独立发行分别登记,不沿用补强前353项作为最终结果。