Show HN: Mcptoon – ツール発見トークンを97%削減するMCP CLIクライアント
Show HN: Mcptoon – MCP CLI client that cuts tool discovery tokens by 97% (github.com)
要約
Mcptoonは、AIエージェントがMCP(Model Context Protocol)サーバーと通信する際のトークン消費を大幅に削減するCLIクライアントです。特にツール発見時のJSONオーバーヘッドを97%削減し、TOON(Token-Optimized Object Notation)という独自の軽量フォーマットを使用します。依存関係ゼロのPython製で、クロスプラットフォーム対応、あらゆるAIエージェントと連携可能です。
全文翻訳
Zero-Config Token Optimization & Unified Governance for MCP Tools and Agent Skills
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.
[画像: PyPI version] [画像: GitHub Stars] [画像: CI Build] [画像: Tests] [画像: Zero Dependencies] [画像: License]
[画像: MCP Spec] [画像: AllMCPs] [画像: MCPVault] [画像: mcpservers.org]
🌐 公式ウェブサイト · 🧮 30秒トークン税計算機 · 🇨🇳 中国語ドキュメント · 📖 開発者ドキュメント
[画像: mcptoon ベンチマーク: 71,929 トークンから 581 トークンへ (-99.2%)]
mcptoon-promo-final-v10-en.mp4[動画]
⚡ コア機能の概要
| 💰 トークン & コンテキスト最適化 | 🛠️ ユニバーサルツール管理 |
|---|---|
• ✅ コンパクト名インデックス (-99.2%): 72k トークン → 581 トークンの名前のみのインデックス • ✅ ロスレス圧縮 (CCR): ハンドル取得 (retrieve) で復元可能 • ✅ セッション重複排除: ターンごとにバイト単位で同一出力の重複をブロック • ✅ 正確な測定: mcptoon bench による実際の tiktoken カウント | |
• ✅ 17,000+ レジストリ発見: 自然言語検索 (search) • ✅ 統一CLI実行 (call): 任意のMCPツールのヘッドレスドライバ • ✅ オンデマンド検査 (inspect): 必要になったときにのみスキーマを取得 • ✅ 診断ドクター (doctor): stdio パイプ & 環境を自己修復 |
| 🧠 スキルガバナンス | 📚 ゼロコストドキュメントルーティング (mcptoon docs) |
|---|---|
• ✅ シングルソースマルチエージェント同期: Claude, Cursor, Roo, OpenCode • ✅ 自己インストールスキル付属: 公式エージェントスキル /mcptoon をバンドル • ✅ オフラインBM25スキルルーター: <5msのマッチング、モデルAPIコストゼロ • ✅ バージョンゲート (--version-gate): バージョン未記載コンテンツのドリフトをブロック • ✅ 墓石除去: git pull によるデッドスキルの復活を防ぐ | |
| • ✅ Markdownツリーインデックス: 大規模ドキュメントディレクトリの自動インデックス • ✅ ターゲットチャプターフィード: 19チャプターではなく1チャプターをフィード • ✅ モデルオーバーヘッドゼロ: 純粋なオフラインBM25キーワードマッチングエンジン • ✅ コンテキスト税シールド: 40kドキュメントトークンをルックアップごとに17kに削減 |
| 🔌 103+ AIクライアント対応 | 🛡️ エンジニアリング規律 |
|---|---|
| • ✅ 103+ クライアント標準搭載: Claude Code, Cursor, Windsurf, Zed, Cline... • ✅ デュアルモード (CLI & ネイティブMCP): 42 CLI直接 + 61 MCPフォールバック • ✅ 透過的なセッションフッター: ターン終了後にライブ節約額の内訳を表示 | |
• ✅ 依存関係ゼロ: 100% Python標準ライブラリ (pyproject.toml クリーン) • ✅ 超軽量: 総パッケージフットプリントわずか363KB、2秒でインストール • ✅ 100%ローカル & プライベート: クラウドコールなし、テレメトリなし、エアギャップ対応 • ✅ 厳格なXDG準拠: --dir によるサンドボックスフレンドリーな設定分離 |
🚀 クイックスタート (好きな方法を選んでください)
🤖 モダンな方法: エージェントと話すだけ (記憶ゼロ)
インストールすると、mcptoon は自動的に公式スキル (/mcptoon) をエージェントに注入します。ターミナルコマンドを覚える必要はありません — Cursor, Claude Code, Windsurf, または DSH で直接尋ねるだけです:
# 組み込みスキルはいつでも呼び出せます:
"Load /mcptoon skill and check what MCP tools I currently have."
"Help me find an MCP tool that converts HTML to PDF and call it."
"The tool output was truncated, retrieve the full original copy."
"How many tokens did mcptoon save for me today?"
"Doctor self-check: are all my MCP servers connected properly?"
エージェントが /mcptoon をロードし、バックグラウンドですべてを処理します!
⚡ ターミナル方法: 30秒セットアップ
# 1. インストール (依存関係ゼロ、363KB)
pip install mcptoon
# 2. ワンコマンド: MCPサーバーを検出し、エージェントを自動設定
# (検出されたすべてのAIエージェントに `/mcptoon` スキルも自己インストールします)
mcptoon quickstart
# 3. コンパクトなツールカタログを表示 (-99.2% トークン)
mcptoon manifest
# 4. スキルまたはドキュメントチャプターにタスクをルーティング (<5ms)
mcptoon skills resolve "write git commit message"
mcptoon docs resolve "how does release gating work"
実際に何か節約できていますか? 新規インストール後、mcptoon は直接モード (インストール済みだがエージェントに接続されていない状態) で動作し、何も節約しないことがあります。 どのモードが最も安価か? を参照するか、単に mcptoon mode を実行してください。
なぜmcptoonなのか
すべてのMCPエージェント (Claude Code, Cursor, Codex, …) は、作業を行う前に、すべてのツールとスキルの完全な説明をコンテキストウィンドウにロードし、それを各ターンで再送信します。255個のツールでは、これは 71,929トークン になります。最初の質問をする前に、128Kウィンドウの半分以上が説明に費やされます。
トークン節約の仕組み
mcptoon は、これらの説明をコンテキストではなくディスク上に保持し、エージェントにはコンパクトなビューを提供します:
- 名前インデックス、フルスキーマではない。 ツールを選択するには名前だけで十分です — 255個のツールは 581トークン (−99.2%) になります。フルスキーマは、ツールが実際に呼び出されたときにのみ
mcptoon inspectでオンデマンドで取得されます。 - スキルも同様。 1つの常駐ポインタ (39トークン) と1回のルックアップ (501トークン) で、すべての
SKILL.mdをフルロードする代わりに済みます — 926,232 → 39 + 501 (−99.9%)。 - 結果も同様。
--toonはツールの結果を標準TOON形式で再エンコードします。混合結果サンプルで 5.7% 小さくなり、結果の形状によって 1.8%-48.6% の範囲になります — レコードのリストはほとんど縮小せず、単一レコードは半分になります。一律34%ではありません:assets/benchmark_results.jsonを参照してください。
何も失われません: フルスキーマとフルスキルテキストは、コマンド1つでアクセス可能です。コンテキストウィンドウだけが節約されます。
mcptoon は 363KB、依存関係ゼロのネイティブCLI で、コンピュータ上のすべてのMCPツールとエージェントスキルを管理し、設定なしでそれらをすべてのエージェントと共有します。
これは単なる我々の主張ではない
これらの数値は我々のものです — しかし、「すべてのツールスキーマをコンテキストにロードするのはコストがかかる」というのは、我々だけが主張していることではありません:
- Anthropicのエンジニアリング解説 — ツールスキーマがコンテキストウィンドウを氾濫させるのは現実的なコストです。例では150,000トークンから2,000トークンに削減されています。
- Firecrawlのベンチマーク — 同じタスクがCLI経由では1,365トークン、MCP経由では44,026トークンかかりました (32倍)。
- Scalekitのベンチマーク — CLIは10〜32倍安価で、100%信頼性がありますが、MCPは72%です。
- MCP-Zero (arXiv:2506.01056) — オンデマンドツール取得、ツール数に関わらずほぼ一定のコスト。
mcptoon は今日から使えるものです。シェルを実行できるあらゆるエージェントに対応し、主要なGUIクライアントに単一の接続ラインを記述します。
2つのアクセス方法
🧑💻 AIツールをただ使うだけ
一度インストールすれば、あなたの持つすべてのAI — Claude Desktop, Claude Code, Codex, Cursor, Windsurf, Cline, VS Code Copilot, Gemini CLI, Qwen Code, Zed, Crush, opencode およびその他のエージェント — が、あなたが既に持っているすべてのツールとスキルを共有します。あなたはどのエージェントの設定にも何も記述する必要がありません。
🔧 MCP / エージェントで開発する
スクリプト化します。mcptoon は安定したJSON出力を備えたプレーンなCLIであり、mcptoon serve MCPエンドポイントも提供します — 独自のAIエージェント、CI、またはアプリケーションに組み込んでください。
あなたの数値を測定してください: pip install mcptoon && mcptoon bench — これは固定の255ツールサンプルではなく、あなたのカタログを報告します (サンプルの方法は docs/tiktoken-benchmarks.md にあります)。
| mcptoonなし | mcptoonあり | |
|---|---|---|
| コンテキスト内の説明 | 各ツール+スキルのフル説明、ターンごとに再送信 | コンパクトなビュー — 255ツールで 581トークン (−99.2%、ロスレス) |
| ツールまたはスキルの追加 | 各AIエージェントでJSONを手書き | ワンコマンド — AIエージェントの設定は変更なし |
| どのAIエージェントが利用できるか | 設定したエージェントのみ | マシン上のすべてAIエージェント — mcptoon を実行するだけ |
| ツールとスキルの検索 | GitHubを手動で探す | install --search (17,000+ MCPサーバー) + skills search |
| ゼロから開始 | ツールを1つずつ接続 | 4つの組み込みスターターパック — ワンコマンドで動作セットを構築 |
スキルも同様です: 926,232トークン の SKILL.md テキスト → 39 常駐 + 501 検索ごと (−99.9%)。呼び出し結果は --toon でさらに 約6% 縮小します (形状依存)。
目次
- なぜmcptoonなのか
- トークン節約の仕組み
- これは単なる我々の主張ではない
- 2つのアクセス方法
- Path 1 · AIツールをただ使うだけ
- Path 2 · MCP / エージェントで開発する
- 30秒で開始
- 何をするか
- ツールの入手元
- 3つの請求、そしてなぜ混ぜてはいけないのか
- インストール
- すべてのAIエージェントと連携 — 103クライアント (42 CLI · 61 サーブ)
- なぜプロキシではなくCLIなのか
- どのモードが最も安価か?
- 全コマンド
- 信頼と安全性
- クレジットと参考文献
- 貢献
- トラブルシューティング & FAQ
- ライセンス
30秒で開始
pip install mcptoon # 純粋な標準ライブラリ、363KB、依存関係ゼロ
# ワンコマンド: MCPサーバーを検出、設定を書き込み、ゲートウェイを登録
# あなたが持つすべてのAIエージェントに登録し、検出されたものを表示します:
mcptoon quickstart
# 利用可能なすべてのツールを表示 (デフォルトで名前のみ。255ツールで581トークン):
mcptoon manifest
# ツールを呼び出す (デフォルトでJSON出力。より節約するには --toon を追加)。
# `everything` は既に存在する場合のみ表示されます。それ以外の場合は、まず組み込みの
# 依存関係ゼロのデモサーバーを追加し (Node不要、ネットワーク不要)、それを呼び出します:
mcptoon add demo --stdio python -m mcptoon demo-server
mcptoon call demo echo_message '{"message":"hi"}'
quickstart はmcptoonを可視化するものでもあります: 各AIエージェントの設定に mcptoon serve を予約サーバー mcptoon として書き込みます。これにより、AIエージェントはmcptoon自体を認識できます。既に同期済みですか? mcptoon sync --self で再登録してください (単なる mcptoon sync はあなたのサーバーのみを書き込みます)。いつでも mcptoon status で状態を確認できます。
2つのアクセス方法 — そしてどちらか一方を選ぶ必要はありません。 mcptoonはまずCLIツールです: シェル機能を持つAIエージェントは mcptoon コマンドを実行し、これが最も安価なパスです — スキーマはコンテキストに入りません。quickstart はmcptoon自身のMCPエントリ (mcptoon serve) も各AIエージェントに登録するため、MCPサーバーしか認識できないクライアントでもあなたのツールにアクセスできます。MCPエントリは compact モードで提供されます: これはアップストリームツールリストをモデルのコンテキストから除外し、代わりに mcptoon_manifest → inspect → call に送信します。mcptoon status は両方の台帳を表示します。
そして完全に元に戻せます。 インストールはゲートウェイを登録し、デフォルトでquickstartは引き継ぎます — 既存のサーバーをゲートウェイ経由でルーティングし、それらの直接エントリを削除します (このステップがないと、AIエージェントは同じツールを2回認識し、コストが高くなります)。これはリストされた確認済みのステップであり、元に戻せます: mcptoon restore はゲートウェイエントリを削除し、サーバーを元の状態に戻します。 後で設定に追加したものはすべて変更されません。mcptoon off はより軽量なスイッチです — ゲートウェイエントリのみを削除し、サーバーはそのままです。どちらも --dry でプレビューでき、完全な削除計画は mcptoon uninstall --dry でプレビューできます (最初に削除されるものを正確に表示します)。
まだインストールしたくないですか?代わりに動作を確認してください (Nodeが必要です):
uvx mcptoon demo --quick
これは公式の「すべて」リファレンスサーバーを起動し、1つのツールを呼び出し、画面にトークン計算を表示します — APIキー不要、あなたのサーバー不要、ディスクへの書き込みなし。
何をするか
ツール: スキーマはオンデマンドで
フルスキーマは名前インデックスに圧縮されます。必要な場合は、mcptoon inspect が実際のパラメータを取得し、call がそれを実行します。あなたはリスト表示に対して支払い、各ターンに対してではありません。
スキル: 1つの常駐ポインタ
カタログ全体をロードする必要はもうありません。単一のポインタ行が常駐し (39トークン)、1回のルックアップで最も関連性の高いスキルが返されます (501トークン)。ビューはリンクです (Windowsではジャンクション、管理者不要)、ソースでの1回の編集はどこでもライブになり、2番目のコピーがドリフトすることはありません。
一度インストールすれば、どこでも共有
mcptoonを一度インストールすれば、マシン上のすべてのAIがあなたのすべてのツールとスキルを利用できます。後で追加しても、すぐに利用可能になります — AIエージェントの再起動、AIエージェントごとのJSON設定は不要です。
ツールを好きなように追加
mcptoon install brave-search --npm @modelcontextprotocol/server-brave-search
mcptoon install my-tool --pip mcp-my-tool
mcptoon install remote-api --url https://example.com/mcp
mcptoon add my-server --stdio npx -y @any/mcp-package
mcptoon install --list # インストール済みを表示
mcptoon install --remove brave-search # 1つをアンインストール
npm / pip / HTTPから、サーバーごとに1コマンド。またはmcptoonに既存のものをスキャンさせます: mcptoon discover。
トークンが必要なリモートサーバーは、環境から読み取るため、認証情報はディスクに書き込まれることはありません:
mcptoon install remote-api --url https://example.com/mcp \
--header 'Authorization: Bearer ${BAIZHI_TOKEN}' # BAIZHI_TOKEN は環境変数に設定
${NAME} はリクエスト時に解決されるため、設定、生成されたハンドラ、およびすべてのログはテンプレートを保持します — 変数をローテートすれば、次の呼び出しで新しい値が使用され、再インストールは不要です。欠落または空の変数は、それを名前として、空のヘッダーとしてではなく、大きな音で失敗します。
ツールの入手元 — 17,000以上を検索、ワンコマンドでインストール
新しいマシンでは、最初の質問は「トークンをどう節約するか」ではなく、「そもそもどんなツールが欲しいか」です。以前の答えは、GitHubで mcpServers スニペットを探し、JSONに手動でコピーすることでした。
mcptoon はツールを配布せず、カタログもバンドルしません。アップストリームレジストリにクエリを送信するため、必要なものを正確に検索できます:
mcptoon install --search github # 検索のみ — インストールなし
mcptoon install --search postgres
mcptoon install github # 検索してインストール
結果には ✓ (レジストリ検証済み)、タイプタグ (npm / pypi / hosted / remote)、および呼び出し回数が含まれます。データは2つのアップストリームから取得され、ライブでクエリされ、決して保存されません:
| ソース | 内容 | スケール |
|---|---|---|
| Smithery | 最大のMCPレジストリ | 17,000以上のエントリ |
| 公式MCPレジストリ | 公式メタレジストリ | インストール可能なnpm / pypiパッケージ |
なぜ何もバンドルしないのか: バンドルされたリストはリリースごとに更新が必要で、他者のソースをあなたのサプライチェーンに引き込むことになります。mcptoonはポインタのみを保存します — 検索はあなたの ~/.mcptoon/config.json に1行書き込みます。サードパーティのソースがmcptoon内に格納されることはありません。
その後、すべてのAIエージェントに配布します:
mcptoon sync # 新しいツールを検出されたすべてのAIエージェントにプッシュ
mcptoon manifest # すべてのツールを表示 (名前インデックス、最も安価なビュー)
結果の読み方: インデックスには、公式の @modelcontextprotocol/* サーバーと個人が公開したパッケージが混在しています。✓ はレジストリがエントリを検証したことを意味します — 認証情報を渡す前にソースを読むための合図です。
スキルの部分: skills search <query> はオープンなスキルインデックス (skills.sh) をクエリします — 何をするかによってスキルを見つけ、skills add <git-url> でインストールします。mcptoonはあなたが指定したリポジトリをインストールします — カタログはオープンなエコシステムそのものです。
スターターパック: ツールを個別に選択したくない場合は、4つの組み込みパック — essentials, web-research, code-review, docs — がそれぞれいくつかのツールとすぐに使えるプロンプトをバンドルしています。mcptoon install --packs でリスト表示し、mcptoon install --pack essentials で1つインストールします。2つのリサーチパックはAPIキーを必要としません。
3つの請求、そしてなぜ混ぜてはいけないのか
mcptoonは3つの別々の場所でトークンを節約します。それらを横断して数値を比較しても意味がありません。
以下の数値は、3つの異なるサイズのカタログから取得されています — 255ツールの合成サンプル (固定のヘッドラインベンチマーク)、1,109ツールのマシン、そしてあなたのマシンにあるもの。あるパーセンテージを別のトークン数と比較しないでください。各テーブルは測定されたカタログを示しています。
「これはどれだけ節約できるか?」という問いには2つの読み方があり、それぞれ異なる質問に答えます。ゲートウェイの数値 — フルスキーマと、デフォルトの compact 表示でAIエージェントが実際にロードするもの — は、mcptoonをインストールすることで得られるもので、正直なヘッドラインです (カタログサイズとともにスケールします: ツールの数が多いほど大きくなります)。スリムスキーマの数値 (同じツール、より簡潔な説明) は、より小さい二次的な主張 (88.5%) であり、manifest --slim が提供するものです。mcptoon status は両方を並べて表示し、2つがずれることはありません。
請求1 · ツール発見 (manifest): デフォルトで99.2%削減
フラグなしの mcptoon manifest はこのティアです。さらに必要ですか? --slim (名前とパラメータタイプ、8,282トークン、−88.5%) または --full (完全なスキーマ)。
請求2 · 呼び出し結果 (call): オプション、--toon で約6%節約
この請求は、ツールが返された後に発生します。mcptoon call はデフォルトでJSONを出力し、デフォルトでは何も節約しません。結果を縮小するには --toon を追加してください。
請求3 · スキルカタログ (skills): 926,232 → 39 常駐 + 501 検索ごと
mcptoon skills manifest # 39トークン、常駐
mcptoon skills resolve "make a PDF" --k 5 # 501トークン、最も関連性の高い5つ
1つのテーブル、すべて3つ、このREADMEが書かれたマシンで:
| パス | AIエージェントがロードするもの | トークン | ネイティブ比 |
|---|---|---|---|
| ツールスキーマ (1109) | 各フルスキーマ | 139,863 | — |
manifest (名前インデックス) | 5,406 | 96.1% | |
manifest --slim | 16,396 | 88.3% | |
| スキルファイル (371) | 各 SKILL.md、フルテキスト | 926,232 | — |
skills manifest (ポインタ) | 39 | 100.0% | |
skills resolve --k 5 | 501 | 99.9% |
固定ヘッドラインベンチマーク — 50サーバーにわたる合成サンプル255ツール、tiktoken cl100k_base。これはあなたのカタログではありません。あなたの数値を表示するには mcptoon status を実行してください:
| フォーマット | トークン | 節約 |
|---|---|---|
| JSON | 71,929 | — |
| TOON | 47,438 | 34% |
| SLIM | 8,282 | 88.5% |
| Compact | 581 | 99.2% |
mcptoon bench であなた自身のカタログを測定してください (これは固定サンプルではなく、あなたのツールを報告します)。上記の正確な3フォーマットテーブルも再現可能です — クローンは不要です:
mcptoon manifest # スキーマキャッシュをポピュレート
python -m mcptoon.bench_tokens # 同じJSON / --slim / --compactカウント、あなたのツール
方法と口径: docs/tiktoken-benchmarks.md。
インストール
pip install mcptoon
Linux (Debian/Ubuntu 23.04+、およびPEP 668に従うディストリビューション)、およびmacOSのHomebrew Python。 システムPythonへのプレーンな
pip installはerror: externally-managed-environmentで拒否されます。これはディストリビューションが自身を保護しているためであり、mcptoonの問題ではありません。代わりにクリーンな方法でインストールしてください:
pipx install mcptoon # CLIを分離します。推奨。
# または、管理下の仮想環境にインストール:
python3 -m venv ~/.mcptoon-venv && ~/.mcptoon-venv/bin/pip install mcptoon
pip install --break-system-packages mcptoon も機能しますが、システムPythonに書き込みます — pipx または venv を優先してください。Windowsでは、pip install mcptoon はそのまま機能します。
その他のインストール方法
# インストールせずに実行 (Nodeが必要)
uvx mcptoon demo --quick
# 隔離されたCLIインストール (Linux / Homebrew PythonでのPEP 668エラーを回避)
pipx install mcptoon
# ソースから (開発用)
git clone https://github.com/activeing123/mcptoon.git
cd mcptoon
pip install -e . --no-build-isolation
# Claude Code プラグイン
/plugin marketplace add activeing123/mcptoon
Nix
numtide/llm-agents.nix によってパッケージ化されています — ボットがPyPIの全リリースを追跡するため、flakeは手動でバージョンが遅れることはありません:
# flakeから直接実行、インストールステップなし
nix run github:numtide/llm-agents.nix#mcptoon -- --help
プラグインとスキルは両方とも sudosubin/agents.nix を通じて pkgs.agent-plugins.github.activeing123.mcptoon.<plugin-name> および pkgs.agent-skills.github.activeing123.mcptoon.<skill-name> として公開されています。
すべてのAIエージェントと連携
mcptoonはAIエージェントに2つの方法で到達し、以下のすべてのクライアントがいずれかに該当します。あなたは選択しません — quickstart は両方を登録し、各ホストは利用可能な方を受け取ります:
- CLIレッグ — AIエージェントが
mcptoon自体を実行します。 シェルを持つもの (CLIエージェント、またはターミナルを持つコーディングIDE) は設定不要です:mcptoon call,mcptoon search,mcptoon skills resolveを実行します。AIエージェントには何も書き込まれません。 - serveレッグ — クライアントはシェルを実行できません。 チャットアプリやGUIはMCPをマウントするため、1つのエントリ (
mcptoon serveを単一のMCPサーバーとして) を取得します。1行、1箇所。
市場をカバー。 103クライアント、awesome-mcp-clients から取得し、コーディングAIエージェントのベンダー文書を追加しました。開発者ライブラリ (mcp-agent, mcp-client-go) は除外されています。なぜなら、ユーザーはそれらを直接実行しないからです。証拠はクライアントごとです — 検証したものを記載し、仮定したものではありません。
CLIレッグ — 42クライアント、設定不要 (これらは mcptoon を実行します):
AdaL · Aider · Amazon Q Developer · auggie · Autohand Code CLI · Claude Code · Claude Code Open · ClaudeMind · Cline · Codex · ContextKit · Continue · Copilot CLI · Copilot-MCP · Crush · Cursor · Dexto · Dolphin-MCP · Enola · Gemini CLI · Goose · JDBCX · Junie · KiloCode · Kiro · McPico · MCPOmni Connect · mistral-vibe · Nerve · Octomind · opencode · OpenHands · PraisonAI · Qwen Code · Roo Code · Slack MCP Client · SwarmClaw · Trae · VS Code GitHub Copilot · Warp · Windsurf · Zed
serveレッグ — 61クライアント、1つの mcptoon serve エントリ (シェルがないため、MCPをマウントします):
5ire · Agent Bridge · Agent-cli · AgentOne · AIaW · Ano · AnythingLLM · Argo-LocalAI · askit-mcp · AstrBot · BoltAI · BrowseWiz · Canvas MCP Client · CarrotAI · Chainlit · ChatMCP · Cherry Studio · Claude Desktop · console-chat-gpt · DeepChat · DocsGPT · eechat · Enconvo · Fastchat MCP · FLUJO · Glue · HyperChat · kibitz · Klavis AI · LangBot · LibreChat · LobeHub · Lutra · MCP Chatbot · MCP CLI client · MCP Playground · MCP Simple Slackbot · MCP SuperAssistant · MCPCLIHost · MCPHost · Memex · MindPal · NextChat · OpenClaw · oterm · Qordinate · Runbear · SeekChat · Simple AI · Superinterface · Tambo · Taskade · Tester MCP Client · Tiles Notebook · Tome · Vercade · WhatsMCP · Witsy · y-cli · Yume · Zin-MCP-Client
証拠ステータス — sync --self は、検証済みの12ホストに単一の mcptoon エントリを書き込みます。上記以外のホストはCLIまたは mcptoon serve で到達するため、ホスト固有のファイルは不要です。したがって、ホストごとの検証は不要です。
mcptoonがホストごとに書き込むもの
mcptoonはCLIツールです — マネージャーであり、常駐プロキシやサービス、クライアントライブラリではありません。あなたのAIエージェントはアップストリームMCPサーバーと直接通信しません: mcptoon コマンドを実行するか、mcptoon自身のMCPエントリ (mcptoon serve) を介して到達します。ファイルを受け入れるホストの場合、これは正確にどこに何が配置されるかです:
| AIエージェント | 接続方法 |
|---|---|
| Claude Desktop | mcptoon sync --self が claude_desktop_config.json に単一の mcptoon エントリを追加 |
| Claude Code | mcptoon sync --self が ~/.claude/CLAUDE.md に設定とポインタを書き込む |
| Codex | mcptoon sync --self が ~/.codex/AGENTS.md にポインタを書き込む |
| Gemini CLI | mcptoon sync --self が ~/.gemini/GEMINI.md にポインタを書き込む |
| Qwen Code | mcptoon sync --self が ~/.qwen/QWEN.md にポインタを書き込む |
| Zed | mcptoon sync --self が Zedの AGENTS.md にポインタを書き込む |
| Crush | mcptoon sync --self が ~/.config/crush/CRUSH.md にポインタを書き込む |
| opencode | mcptoon sync --self が ~/.config/opencode/AGENTS.md にポインタを書き込む |
| Cursor | mcptoon sync --self が CursorのMCP設定に追加します。または AGENTS.md に配置します |
| Windsurf | mcptoon sync --self が mcp_config.json を書き込む |
| Cline | mcptoon sync --self が ClineのMCP設定を書き込む |
| VS Code Copilot | mcptoon sync --self が VS CodeのMCP設定を書き込む |
| シェルを実行できるあらゆるAIエージェント | mcptoon を直接呼び出す — 設定不要 |
# AIエージェントがタスク中にGitHubアクセスを必要とする場合、実行するのはこれだけです:
mcptoon add github --url https://api.githubcopilot.com/mcp/
# 完了。JSON編集不要。再起動不要。コンテキスト喪失なし。
mcptoon serve は逆方向です: 設定済みのすべてのサーバーを単一のMCPエンドポイントの後ろに配置し、接続プーリングとAIエージェントごとのキーを備えています。プロキシを主張するクライアント向けです。両方を自分で選択する必要はありません — CLIはプライマリなアクセス方法であり、ホストが対応できる場所ではブリッジが並行して配線されます。
なぜプロキシではなくCLIなのか
MCPの前提は、すべての機能がAIエージェントが接続するように設定する必要があるサーバーであるということです — だからこそ、新しいツールが1つ追加されるたびに、AIエージェントごとに異なる形式でJSONを編集し、すべてを再起動し、各AIエージェントでフルスキーマコストを再請求する必要があります。
コマンドラインは、すべてのAIエージェントが既に持っている唯一のインターフェースです。そして、mcptoonが何もする前に、そのフォームファクターはそれ自体で測定可能なほど安価です:
- Firecrawl: 同じタスクがCLI経由では1,365トークン、MCP経由では44,026トークン — 32倍かかりました。
- Scalekit: CLIは10〜32倍安価で、100%信頼性がありますが、MCPは72%です。
プロキシ形式も存在します — mcptoon serve は設定済みのすべてのサーバーを単一のMCPエンドポイントの後ろに配置します。そして quickstart はそれをCLIと並行して配線するため、選択する必要はありません。このセクションは、mcptoonが構築されている形状に関するものであり、切り替える必要があるスイッチではありません。
どのモードが最も安価か?
mcptoonがAIエージェントにツールを渡す方法は3つあり、それぞれコストが大きく異なります。1つだけが最も安価であり、それは新規インストールが開始される状態ではありません。(以下のトークン数値は255ツールサンプルからのものです。あなた自身のカタログは異なります — mcptoon mode があなたの数値を表示します。)
| モード | AIエージェントがロードするもの | 各ターン固定コスト | 使用時期 |
|---|---|---|---|
| CLI (最も安価) | コマンドを実行するまで何もロードしない — その後、名前インデックス (255ツールで581トークン) と必要な1つのスキーマ | 0 | シェルを実行できるAIエージェント |
| serve | 各アップストリームスキーマの代わりにmcptoon自身のゲートウェイツールをロード (カタログサイズにスケールするゲートウェイの数値) | 小さく、固定 | MCPサーバーしか認識できないクライアント |
| direct | 各ツールのフルスキーマ (255ツールサンプルで71,929トークン) | 最大 | mcptoonがインストールされているが、AIエージェントに接続されていない場合。新規インストールがこの状態であり、mcptoonが目に見えないように感じられる理由です。mcptoon quickstart を実行するまで。 |
CLIが最も安価なのは、アイドル時にコストゼロだからです。 ツールを使用しないターンではコストがかからず、ツールを使用するターンでのみ数百トークンかかります。serve はそれに次いで安価で、各ターンで少額の固定料金がかかります。direct はmcptoonがインストールされているがAIエージェントに接続されていない場合に支払うものであり、新規インストールがこの状態です。そのため、mcptoon quickstart を実行するまでmcptoonは目に見えないように感じられることがあります。
「99%」という数値はこのREADMEの定義側の節約 — すべてのスキーマをロードしないことによるものです。CLIとserveの両方がこれを得ますが、directは得ません。結果の圧縮は、それとは別の、はるかに小さい請求 (請求2) であり、インストールする理由にはなりません。
あなたがどのモードにいるか — そしてそれがあなたのカタログでどれだけコストがかかるか — を mcptoon mode で確認してください。ステータスバーやターンヘッダー用の1行バッジは mcptoon statusline で表示できます。
全コマンド
mcptoon quickstart # ワンショット開始 (検出 + 設定 + ゲートウェイ登録)
mcptoon discover # このマシンでMCPサーバーをスキャン (--writeで保存、--healthでプローブ)
mcptoon import # Claude Desktop / Cursor / Cline / Windsurf からサーバーをインポート
mcptoon init # サンプル設定を作成 (--autoで検出して入力)
mcptoon list # 設定済みのサーバーを表示
mcptoon manifest # すべてのツール名 (デフォルトでコンパクト; 255ツール = 581トークン)
mcptoon manifest --slim # 名前 + パラメータタイプ (8,282 vs 71,929 = −88.5%)
mcptoon inspect <server> <tool> # 単一ツールのスキーマを検査
mcptoon search <query> # サーバー全体でツールを検索
mcptoon select "<task>" # タスクに対する上位3ツール (過去約40ツール、モデルが間違えることがある)
mcptoon select "<task>" --top 5 # または希望する数
mcptoon call <server> <tool> '{"args":"here"}' # ツールを呼び出す
mcptoon exec python "print(len(open('big.log').readlines()))" # コードを実行; 標準出力のみがコンテキストに入る
mcptoon exec python --file analyze.py # スクリプトファイルから同様に実行
mcptoon exec --langs # このマシンで実際に実行可能なもの
mcptoon add <name> --stdio|--http <cmd|url> # 任意のMCPサーバーを追加
mcptoon remove <name> # サーバーを削除
mcptoon install <name> --npm|--pip|--url <pkg> # インストール + ハンドラ自動生成
mcptoon install --search <kw> # ライブレジストリを検索 (何もインストールされない)
mcptoon update # 各サーバーのキャッシュされたツールサーフェスを更新; 変更されたものを報告
mcptoon plugin install <dir> # Agent Plugins 1.0.0 プラグインをインストール
mcptoon sync # ネイティブ設定を検出されたすべてのAIエージェントに同期
mcptoon health # 各MCPサーバーのヘルスチェック
mcptoon serve # MCPサーバーとして実行 (stdio/HTTP)
mcptoon skills list # スキルカタログをリスト表示 (--usageでヒット数を追加)
mcptoon skills sync <src> # スキルカタログを各AIエージェントのフォルダに配布
mcptoon skills resolve "<task>" # スキルのBM25ショートリスト (オフライン、LLMなし)
mcptoon docs index <dir> # Markdownツリーをインデックス化し、AIエージェントが全体を読むのを停止させる
mcptoon docs resolve "<query>" # クエリに最適なファイル — パスを返す (オフライン)
mcptoon docs list # インデックス化されたすべてのドキュメント、スラッグ別
mcptoon docs doctor # ディスクに対してドキュメントインデックスをチェック
mcptoon kb index <path> # ドキュメントをインデックス化し、内部を検索可能にする
mcptoon kb fetch <url> # URLを取得してインデックス化 (24時間TTLキャッシュ)
mcptoon kb search "<query>" # ファイル全体ではなく、ランク付けされたパッセージ (porter + trigram, RRF)
mcptoon kb list # インデックス化されたソース、サイズと日付付き
mcptoon kb stats # チャンク、DBサイズ、トリグラムサポート
mcptoon session # 今セッションで何が起こったか (コンパクション後にキャッチアップ)
mcptoon bench # このマシンでの節約を証明 (ツール + スキル、1つのテーブル)
mcptoon demo # ワンコマンド、ローカルでのライブデモ
mcptoon demo-server # ダウンロードなしの同じ証明 (11の標準ライブラリツール)
mcptoon doctor # 自己チェック: Python、設定、接続性
mcptoon status # 1画面: 設定内容、ゲートウェイ接続、節約トークン
mcptoon stats # トークン節約ダッシュボード (生JSON比)
mcptoon report # 全節約アカウント: ツール + スキル + 累積
mcptoon savings # 達成したマイルストーン (1B? 約12,000冊の小説?)
mcptoon credit # 1画面: あなたのモード、実際の節約額、1つのアクション
mcptoon mode # どの配信モードか (cli/serve/direct) とそれぞれのコスト
mcptoon statusline # ステータスバーやターンヘッダー用の1行節約バッジ
mcptoon usage # ローカル呼び出し統計
mcptoon activity # 誰が、いつ、何をmcptoonで使用したか (直近20回の呼び出し)
mcptoon footer-facts # チャットフッター用の1行節約情報 (ブロックしない)
mcptoon retrieve <handle> # --smartハンドルで取得した元のデータを取得
mcptoon config # ゲートウェイ設定を表示 (フッター、ウェルカム、言語)
mcptoon toggle <server> <tool> # 単一ツールを有効/無効化 (--listで全表示)
mcptoon policy # ツールごとの圧縮ポリシー (raw / toon / slim)
mcptoon completion ps # シェル補完 (bash/zsh/fish/powershell)
mcptoon off # AIエージェントからゲートウェイエントリを削除 (元に戻せる)
mcptoon restore # ゲートウェイを削除し、サーバーを元に戻す
mcptoon uninstall # 完全クリーンアップ — 計画を最初に表示 (--dryでプレビュー)
完全なリファレンスは DEVELOPERS.md にあります。
フォーマットファミリー: 4つのティア、デフォルトでコンパクト
すべてオプションです。デフォルトは既に最も軽量なティアです。
| ティア | 出力 | ネイティブスキーマ比 | 起源 |
|---|---|---|---|
| compact (デフォルト) | 名前のみ search_web | 99.2%削減 | 一般的な設計 |
| slim | 名前 + パラメータタイプ `search_web | query:s*` | 88.5%削減 |
| full | パラメータ付きフルスキーマ | ベースライン | ネイティブMCP |
| toon (結果) | 復元可能な構造化エンコーディング | 混合サンプルで5.7% (形状により1.8-48.6%) | オープンTOON標準 |
なぜデフォルトでコンパクトなのか? どのツールを使用するかを選択するには名前だけで十分です (255ツールで581トークン)。パラメータの詳細は呼び出し時に重要であり、オンデマンドで取得されます。デフォルトでフルスキーマを渡すと、99.2%の節約をそのまま返してしまうことになります。
AIエージェントへのルール: manifest を選択に使用し、呼び出す前に inspect を使用します。 41のライブツールで測定: 名前だけで引数を推測するAIエージェントは約10%の有効な呼び出しを達成しますが、ターンごとに使用する2〜3個のツールに対して1回 inspect を実行するAIエージェントは100%を達成します — コンテキストコストのわずかな割合で、すべてのスキーマを挿入するのと同等です。
信頼と安全性
単なる363KBのネイティブCLIです — いつでも削除できます。保持すれば、どのAIエージェントに対してもツールやスキルを設定する必要がなくなります。 mcptoonはAIエージェントの設定に触れるため、透明性が高く、簡単に離れられるように構築されています。
すべてのツール結果がAIエージェントに表示される前に、3つのガードがデフォルトで実行されます:
| ガード (デフォルトでオン) | 内容 |
|---|---|
| 破壊的アクションブロック | --destructive を渡さない限り、危険な呼び出しは拒否されます |
| プロンプトインジェクションガード | 結果は「以前の指示を無視する」のようなインジェクションパターンをスキャンし、ブロックされます |
| 認証情報漏洩検出 | APIキーやトークンを含む結果は、コンテキストに入る前にブロックされます |
- 元に戻せる。
mcptoon restoreは引き継ぎを元に戻します (ゲートウェイを削除し、サーバーを元に戻します)。mcptoon offはゲートウェイエントリのみを削除します。mcptoon uninstall --dryは最初に完全な削除計画を表示します。サーバーは要求されない限り削除されません。 - テレメトリなし。 分析、クラッシュレポート、電話ホームなし。
- ローカルファースト。 あなたのツール、スキル、ファイルはあなたのマシン上に留まります。唯一外部に出るのは
install --searchで、レジストリにカタログリストを問い合わせます — あなたのデータは送信されません。 - 認証情報保存なし。 APIキーは、設定または環境から直接渡されます。
- 依存関係なし。 純粋なPython標準ライブラリ — サプライチェーンに監査すべきものはありません。CIは
scripts/check_zero_deps.pyでこれを強制します。 - デーモンなし。 純粋なCLI — 常駐プロセスなし、リスニングポートなし。
- フォーマットは互換性を壊さない。 ワイヤープロトコルは常に標準JSON-RPCです。コンパクト/スリム/トゥーンはmcptoonのAIエージェントへの出力のみに影響します。
--toonのデコードが失敗した場合、JSONにフォールバックし、--fullでネイティブスキーマが復元されます。ロックインなし。
範囲、1行で: mcptoonはインデックスと設定マネージャーです — 各ツールの独自のソースを指し示し、あなたはそれらを自身の条件でレビューできます。
クレジットと参考文献
- TOON標準 — v4.1 (MIT)、python-toonからベンダーされ、NOTICEでクレジットされています。
- ToonDeck — mcptoonのGUIコンソール (プレアルファ): 同じエンジン、ポイントアンドクリックでコマンド入力の代わりになります。
開発者: mcptoonは@activeing123 によってメンテナンスされている独立したサードパーティプロジェクトです。Anthropicとは提携していません。
貢献
git clone https://github.com/activeing123/mcptoon.git
cd mcptoon
pip install -e . --no-build-isolation
pip install pytest pytest-cov
python -m pytest tests/ -v # 2671 passed, 2 skipped
3つのハードルール: 依存関係ゼロ (CIで強制)、新しい動作はテストと共に提供、Windowsは第一級ターゲットです。新規ですか? CONTRIBUTING.md と DEVELOPERS.md から始めてください。
コードベース: 50モジュールにわたる35,186行のPython、サードパーティ依存関係ゼロ。
サポート
エラーに遭遇しましたか? トラブルシューティング & FAQ は一般的なものをカバーしています (Server 'X' not configured、skills sync の誤削除ゲート、不明なコマンド/オプション終了コード、節約が99%ではなく100%と表示される理由、スキルカウントの遅延など)。
mcptoonは個人によるサイドプロジェクトであり、個人向けには無料のままです。もしコンテキストコストを削減できたなら:
- GitHubでスポンサーになる — 一時的または月額。
- リポジトリにスターをつける — これが他の開発者が小さなツールを見つける方法です。
チーム機能はまだ構築されていません。 すべてのチームメンバーのマシンに同期される共有サーバーリスト。いつ何がハイドレーションされたかのログ。価格設定や待機リストページはありません — activeing123@gmail.com にメールすれば、優先順位が上がります。
ライセンス
Apache 2.0。 LICENSE および NOTICE を参照してください。
mcptoonは独立したサードパーティMCPクライアントであり、Anthropicとは提携していません。
mcptoonがコンテキストコストを削減した場合、スターをつけてください — これが他の開発者が小さなツールを見つける方法です。