40 lines
4.9 KiB
Markdown
40 lines
4.9 KiB
Markdown
# 项目所属 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)。
|