activeing123/mcptoon

★ 18PythonApache-2.0

一个能让AI代理挂载1000个工具却不占用对话上下文空间的命令行工具

当AI代理连接多个MCP工具服务器时,光是工具说明(schema)就可能在正式干活前吃掉数万个token的上下文空间。mcptoon把这些schema完全排除在上下文之外,让代理改用shell命令按需调用工具。调用结果还会用一种叫TOON的压缩格式表示,相比普通JSON最多可减少93%的体积。

它做什么

MCP(Model Context Protocol)是让AI代理使用外部工具的标准协议,但常见客户端在启动时就把所有工具的schema加载进上下文窗口,连接10个服务器就可能烧掉5万到10万以上token。
mcptoon本身是一个CLI命令行工具,而不是MCP服务器。代理不需要编辑mcpServers这类JSON配置文件,而是在shell里直接运行mcptoon命令,schema只留在磁盘上的配置文件里,不会进入上下文窗口。
工具采用懒加载机制,即使配置了1000个服务器,在你真正调用某个工具之前一个都不会启动。
调用结果可以用Compact、SLIM、TOON三种压缩格式返回。根据仓库自测(使用tiktoken cl100k_base分词器),255个工具的schema从JSON的90804个token,用Compact压缩后降到117个token(节省99.9%),用SLIM压缩后为6174个token(节省93%),而TOON格式编码的调用结果比JSON小30%到40%。
内置三层安全防护:提示词注入检测、凭证泄露检测、以及对删除等危险操作的默认拦截,且完全零第三方依赖,只用Python标准库实现。

经常在不同AI编程代理之间切换的开发者可以沿用同一套工具配置而无需重新设置,把宝贵的上下文空间留给实际工作内容而不是工具说明。随着接入工具数量增多,这种方式避免了传统MCP方案里上下文窗口被撑爆的扩展性问题。

仓库简介（英文）

Token-efficient MCP CLI client. 97% less tokens on tool discovery, 40-60% on results. Zero deps. Cross-platform. Works with every AI agent.