ToolYour

Open-source ToolYour MCP

面向 AI Agent 的远程 MCP 网关：规划 → 运行 playbook/求解 → 验证直至通过。

采用 MIT 许可。托管 API/SaaS 后端为可选项——离线评估和本地文件控制平面无需依赖它们。

产品文档： https://www.toolyour.com/developers/mcp
官方注册表： com.toolyour/mcp
npm 客户端（独立）： @toolyour/sdk（MIT）

快速开始

cp .env.example .env
npm install
npm run build:registry   # from monorepo docs/ when regenerating
npm run build
npm run dev

端点：http://localhost:3090/mcp（兼容主机使用的旧版 SSE） · Streamable HTTP：/mcp 或 /mcp/http。 API 密钥认证的 Streamable HTTP 端点是无状态的：客户端无需会话 亲和性，过期的 Mcp-Session-Id 会被忽略。受 OAuth 保护的 /mcp/chatgpt 端点有独立的会话行为。

健康状态：GET /health/mcp · 就绪状态：GET /health/mcp/ready · 指标：GET /health/mcp/metrics（Prometheus 文本格式）

身份验证

X-Api-Key: ty_...

与 ToolYour REST 使用相同的密钥。免费套餐：每月 500 点数（工具消耗 1–10 点数）。MCP 仅提供由 API 支持的目录工具（hasApi）。

主机约定

ToolYour 不会取代 Cursor/Claude。主机负责编辑器、git 和终端。Agent 应：

1. plan_task（免费）
2. run_playbook 或 solve_task
3. 在工作区中仅应用排名第 1 的 loop.nextActions
4. 使用先前结果作为基线调用 verify_task，直至 loop.gate 为 pass（或停止）

技能循环响应还包含附加的 execution 封装（runId、intentId、 intentType、idempotencyKey 和 projectScope）。将结果交给 其他 MCP 工具时，请保留此封装。异步任务会复用 execution.runId 作为 get_run 轮询 ID。

在内部，plan_task、solve_task、run_playbook、run_workflow 和 verify_task 使用 统一的 executeIntent 生命周期边界进行关联并生成 execution 封装。 每次调用网关工具时都会结算点数（billing.settledBy = gateway_per_tool）——MCP 不会重复计费。免费的 recall_context 会在重建前召回按用途分类的记忆。

已保存的 Playbook（私有测试版）

已保存的 Playbook 可将可重复的 ToolYour 工作流转换为具名、带版本的配方，供 支持 MCP 的 Agent 再次运行。V1 特意仅指向现有的 ToolYour 技能或 工作流；不会存储任意 shell 命令、控制其他 Agent 或绕过主机 审批。每个账户都有仅限所有者访问的 playbook 和持久化运行回执。

仅在私有/默认 MCP 部署中通过 PLAYBOOKS_BETA=true 启用此功能。测试版新增了 create_saved_playbook、list_saved_playbooks、get_saved_playbook、update_saved_playbook、 run_saved_playbook 和 get_saved_playbook_run。此功能有意不包含在 /mcp/chatgpt 中，因此经审核的公共 21 工具界面保持不变。

有关数据模型、安全执行边界和发布指南，请参阅已保存的 Playbook 测试版设计。

离线评估（无需 API 密钥）

npm run ci                 # build + lint + unit/contract/integration + evals
npm run eval:golden        # routing + jobReport fields + verify gate
npm run eval:playbooks     # skill → workflow → synthesizer matrix + fixture coverage
npm run golden:tier1       # host work-package shapes

测试样例：tests/eval/synth-fixtures.json · 目标：tests/eval/goals.jsonl

可观测性（开放协议）

信号	方式
JSON 日志	始终启用（LOG_LEVEL）
进程内计数器	/health/mcp + /health/mcp/metrics
Spans	设置 OTEL_LOG_SPANS=1 和/或 OTEL_EXPORTER_OTLP_ENDPOINT（OTLP/HTTP JSON → Collector / Jaeger / Tempo）

无需专有 APM。

保持托管的部分（可选）

• 通过网关 + API 密钥实时执行工具
• Feature Memory / 验证配置文件（SaaS Mongo）
• Redis，用于多副本异步 get_run

本地默认使用基于文件的控制平面任务。

许可证

MIT — 参见 LICENSE。