mcptoon:统一管理 MCP 工具与 Agent 技能并压缩上下文的零依赖 CLI
activeing123/mcptoon · One zero-dependency CLI for every MCP server and agent skill. Token optimization, tool discovery and context compression: 71,929 -> 581 tokens (-99.2%, measured), schemas stay out of context. One config for Claude Code, Codex, Cursor, every agent. 341KB, pure Python. | 零依赖 CLI:管所有 MCP 工具与技能,工具发现省 99.2% token。
ELI5:它是什么,解决什么问题
mcptoon 是一个纯 Python 标准库实现的零依赖命令行工具,用于统一管理本机上的 MCP 服务器工具与 Agent 技能。它把工具描述和技能全文留在磁盘上,只向上下文注入紧凑的名称索引,按 README 的实测数据,255 个工具的描述从 71,929 tokens 降至 581 tokens;完整 schema 与技能文本可通过 inspect、retrieve 等命令按需取回,因此压缩是无损的。它还提供 17,000+ MCP 服务器的自然语言检索安装、统一的 call 调用入口、stdio 诊断、离线 BM25 技能与文档章节路由,并向 Claude Code、Cursor、Codex、Windsurf 等 103+ 客户端写入统一的连接配置。
核心能力与快速开始
★ 358 · Python
- 能做什么
- 以紧凑名称索引替代完整工具 schema 注入上下文(README 实测 71,929→581 tokens,无损可 retrieve);技能以常驻指针加按需查询替代整篇 SKILL.md 加载;提供 search 检索 17,000+ MCP 服务器、call 统一调用任意工具、inspect 按需拉取 schema、doctor 修复 stdio 管道;离线 BM25 技能路由(<5ms)与文档章节索引路由;single-source 多 Agent 同步,一次安装被 103+ 客户端共享;mcptoon serve 提供 stdio/HTTP 的单一 MCP 端点,bench 可用真实 tiktoken 计量节省。
- 适用场景
- 多个 AI 编程客户端共用一套 MCP 工具与技能配置;工具或技能数量很多、描述占满上下文窗口时减少 token 开销;在 Claude Code、Cursor、Codex、Windsurf 等客户端间同步技能;在 CI 或脚本中以稳定 JSON 输出调用 MCP 工具;为需要代理的客户端提供统一 MCP 端点。
- 项目形态
- 可直接使用的工具
- 部署方式
- 本地 CLI,通过 pip 安装;安装后执行 mcptoon quickstart 检测并写入各客户端配置,也支持 --dir 与 XDG 规范的沙箱式配置隔离;README 称纯 Python 标准库、无云调用与遥测,可离线/隔离环境使用,具体网络与系统要求未完整说明。
- 主要依赖
- Python 环境与 pip;项目自称零第三方依赖、包体约 363KB;具体支持的 Python 版本、操作系统范围未在摘录中完整说明。
- 使用限制
- 各项 token 节省比例为项目提供的实测/自测数据,未说明通用场景下的稳定收益;README 提到安装后处于 direct 模式时不会产生节省;--toon 结果压缩与结果形状相关(混合样本 5.7%,区间 1.8%–48.6%);云端 API 成本、商用合规限制未说明。
- 许可证
- Apache-2.0
- 最近推送
- 2026-10-20 23:34
资料检查:2026-10-21 07:00 · 卡片整理:2026-10-21 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证
职业应用
程序员
统一管理本机 MCP 工具与 Agent 技能,向 Claude Code、Cursor、Codex、Windsurf 等编码代理注入紧凑工具名索引以压缩上下文,并按需 inspect 取回完整 schema、call 调用工具、doctor 诊断 stdio 连接,用于日常编码与排错工作流。
查看内容依据
One zero-dependency CLI for every MCP server and agent skill. Token optimization, tool discovery and context compression: 71,929 -> 581 tokens (-99.2%, measured), schemas stay out of context.
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。