activeing123/mcptoon

Install 1,000 skills and 1,000 MCP tools locally — and never worry about context flooding.
Cuts tool context by ~90% (99.2% on 255 tools) with zero config across 103+ desktop and CLI agents .
🌐 Official Website ·
🧮 30s Token Tax Calculator ·
🇨🇳 中文文档 ·
📖 Developer Docs
https://github.com/user-attachments/assets/0272d3a8-c74f-428d-8559-fbf804ce0685
⚡ Core Capabilities at a Glance
| 💰 Token & Context Optimization | 🛠️ Universal Tool Management |
| :--- | :--- |
| • ✅ **Compact Name Index (-99.2%)**: 72k tokens → 581 tokens name-only index • ✅ **Lossless Compression (CCR)**: Reversible with handle retrieval (retrieve) • ✅ **Session Deduplication**: Blocks byte-identical output duplication in turn • ✅ **Honest Measurements**: Real tiktoken accounting via mcptoon bench | • ✅ **17,000+ Registry Discovery**: Natural language search (search) • ✅ **Uniform CLI Execution (call)**: Headless driver for any MCP tool • ✅ **On-Demand Inspection (inspect)**: Schema pulled only when needed • ✅ **Diagnostic Doctor (doctor)**: Self-heals stdio pipes & environments |
| 🧠 Skills Governance | 📚 Zero-Tax Docs Routing (mcptoon docs) |
| :--- | :--- |
| • ✅ **Single-Source Multi-Agent Sync**: Claude, Cursor, Roo, OpenCode • ✅ **Self-Installed Skill Included**: Bundles /mcptoon official agent skill • ✅ **Offline BM25 Skill Router**: • ✅ **Version Gate (--version-gate)**: Blocks unversioned content drift • ✅ **Tombstone Removal**: Prevents dead skills from reviving via git pull | • ✅ **Markdown Tree Indexing**: Automatic index over large doc directories • ✅ **Targeted Chapter Feeding**: Feeds 1 chapter instead of 19 chapters • ✅ **Zero Model Overhead**: Pure offline BM25 keyword matching engine • ✅ **Context Tax Shield**: Drops 40k doc tokens to 17k per lookup |
| 🔌 103+ AI Clients Supported | 🛡️ Engineering Discipline |
| :--- | :--- |
| • ✅ **103+ Clients Out-of-the-Box**: Claude Code, Cursor, Windsurf, Zed, Cline... • ✅ **Dual Modes (CLI & Native MCP)**: 42 CLI direct + 61 MCP serve fallback • ✅ **Transparent Session Footer**: Live savings breakdown printed after turns | • ✅ **Zero Dependencies**: 100% Python standard library (pyproject.toml clean) • ✅ **Ultra Lightweight**: Only 363KB total package footprint, installs in 2s • ✅ **100% Local & Private**: No cloud calls, zero telemetry, air-gap ready • ✅ **Strict XDG Compliant**: Sandbox-friendly config isolation via --dir |
---
🚀 Quick Start (Choose Your Way)
🤖 Modern Way: Just Talk to Your Agent (Zero Memorization)
When installed, mcptoon **automatically injects its own official skill (/mcptoon) into your agents**. You never need to memorize terminal commands — just ask directly in **Cursor, Claude Code, Windsurf, or DSH**:
*Your agent loads /mcptoon and drives everything behind the scenes!*
⚡ Terminal Way: 30-Second Setup
bash
pip install mcptoon && mcptoon quickstart
bash
mcptoon install --search github # find and install any MCP server
mcptoon skills search "make a PDF" # find a skill by what it does
bash
mcptoon install --pack essentials
bash
mcptoon manifest --format json # machine-readable tool index
mcptoon call '{}' # call any tool, JSON or --toon output
mcptoon serve # expose every configured server behind one MCP endpoint
bash
pip install mcptoon # pure stdlib, 363KB, zero dependencies
One command: find your MCP servers, write your config, register the gateway
in every agent you have, and show you what it found:
mcptoon quickstart
See every tool available (names-only by default; 255 tools cost 581 tokens):
mcptoon manifest
Call a tool (JSON output by default; add --toon to save more):
mcptoon call everything echo '{"message":"hi"}'
bash
uvx mcptoon demo --quick
bash
mcptoon install brave-search --npm @modelcontextprotocol/server-brave-search