4.9 KiB
项目所属 MCP 工具
当前源码支持项目登记的本地 stdio MCP,使用固定协议 2025-03-26。M1 已补齐开放模式完整记录、分页和原始 JSON Schema;这批源码尚未发行或部署。正式版本与各轮证据分别见完整记录验收和Schema 验收,历史 1.12 的有界设计不再代表默认开放模式。
使用流程
- 从工作台工具菜单打开「项目 MCP 工具」,登记程序绝对路径。脚本入口使用当前宿主 Node.js,接受
.js、.mjs、.cjs;登记后保持停用,不自动安装或执行 shell 字符串。 - 点击「实际探测」并核对启动对象。工作台实际启动所属进程,执行
initialize和完整分页tools/list,保存服务版本、工具原声明、请求轨迹和关闭结果。 - 查看用途与原始参数契约,选择允许模型请求的工具并保存启用。Annotations 是服务器数据,不构成用户授权。程序或契约变化时可立即停用;界面区分「尚未核验」和「实际没有工具」。
- 模型按本轮实际目录的注册 ID、配置修订、契约 SHA 和工具名调用。调用使用用户持久保存的
ask/auto/full权限:ask 请求批准,auto 按现有批准策略处理,full 直接执行并保留自动批准审计,不额外要求模型追问确认。 - 在所属任务的「MCP 运行记录」分页查看原输入和原报告,或下载显示的原件。显示批次不限制总记录数;完整计数与预览分别标明。
原始 Schema 与参数
MCP 2025-03-26 要求 inputSchema 的根为 type: "object",tools/call.arguments 为对象。工作台只核对这些协议外层格式;具体 JSON Schema 语义由声明工具的服务器校验。官方职责与冻结来源见本批计划。
完整保留联合类型、递归或外部引用、嵌套、布尔子 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 收益。最新完整结果、首失败和未尽事项均见验收与回顾。