activeing123/mcptoon

📦 mcptoon – MCPツール＆スキルのためのゼロ設定トークン最適化と統合ガバナンス

概要

• ローカルのAIエージェント（Claude、Cursor、Geminiなど）と、インストール済みのModel Context Protocol（MCP）ツール/スキルの間で動作する、小さな（363 KB）純粋Python製CLIです。
• ツール/スキルの完全なスキーマをLLMのコンテキストウィンドウから除外し、代わりにコンパクトな名前のみのインデックスを提供することで、モデルが処理するテキスト量を99%以上削減します。
• 103以上のデスクトップおよびCLIエージェントで即座に動作し、外部依存関係は不要 – pip install mcptoon だけで完了します。

主な機能

カテゴリ	提供内容
トークン＆コンテキスト最適化	• 名前のみのインデックス（255ツールで72k→581トークン） • 可逆取得（retrieve）によるロスレス圧縮 • セッションレベルの同一出力の重複排除 • mcptoon bench による実世界のトークン計算
ユニバーサルツール管理	• 17,000以上の登録済みMCPサーバーの検索（search） • 任意のMCPツール用の統一CLIドライバー（call） • オンデマンドのスキーマ検査（inspect） • 自己修復診断（doctor）
スキルガバナンス	• 多数のエージェント（Claude、Cursorなど）間での単一ソース同期 • オフラインBM25ベースのスキルルーター（<5ms、モデルコストゼロ） • ドリフト防止のバージョンゲート、不要スキルの削除（tombstone removal）
ドキュメントルーティング	• 自動マークダウンツリーインデックス • チャプターレベルの供給（必要な部分のみ） • ゼロモデルBM25マッチング（検索ごとに約40kトークン削減）
エンジニアリング規律	• 外部依存ゼロ（標準ライブラリのみ） • XDG準拠の設定分離 • 完全ローカル、エアギャップ対応、テレメトリなし

仕組み

1. コンパクトカタログ – ツール/スキル名（と小さなポインター）のみがLLMコンテキストに保持されます。完全なJSONスキーマはディスクに保存され、mcptoon inspect で遅延取得されます。
2. オンデマンド取得 – エージェントがツールを呼び出すと、mcptoon がスキーマを取得し、ツールを実行して結果を返します。オプションの --toon フラグは結果をより小さな「TOON」形式に再エンコードします（混合データで約5%のサイズ削減）。
3. ユニバーサルゲートウェイ – mcptoon serve は、任意の登録済みサーバーへの呼び出しを転送する単一のMCPエンドポイントを公開し、すべてのエージェントが個別設定なしで同じバックエンドを使用できます。

クイックスタート

pip install mcptoon               # ゼロ依存、2秒インストール
mcptoon quickstart                # MCPサーバーを自動検出し、/mcptoonスキルを全エージェントに注入
mcptoon manifest                  # コンパクトなツールカタログを表示（255ツールで581トークン）
mcptoon call demo echo_message '{"message":"hi"}'

エージェントから直接 /mcptoon スキルを読み込むよう指示して対話することもできます – ターミナルコマンドは不要です。

典型的なユースケース

• パワーユーザー – 多くのMCPツールを実行し、ツール説明でトークン予算を消費している方。
• チーム – 多数のエージェントのツール/スキルを個別のJSONを編集せずに一元管理したい場合。
• CI / 自動化パイプライン – 安定したスクリプト可能なインターフェース（mcptoon call …）とオプションのHTTPプロキシ（mcptoon serve）が必要な場合。
• エアギャップ環境 – 追加のランタイム（Node、Docker）のインストールが不可能な環境 – mcptoonは純粋なPython標準ライブラリです。

制限事項 / 注意点

• トークン削減は、エージェントが mcptoon を呼び出せる場合（注入されたスキルまたは mcptoon serve MCPエンドポイントの呼び出し）にのみ適用されます。ツールスキーマをプロンプトにハードコードしているエージェントは、再設定しない限り恩恵を受けません。
• 結果圧縮（--toon）は形状に依存します。一部のペイロードは数%しか縮小しませんが、最大で約50%まで縮小するものもあります。
• mcptoon自体はツールを提供しません – 外部のMCPレジストリからツールを発見またはインストールする必要があります。

ライセンス

• Apache 2.0（LICENSE を参照）。

詳細情報

• 公式ウェブサイト: https://mcptoon.github.io/
• トークン税計算機: https://mcptoon.github.io/tools/token-tax/
• 開発者ドキュメント: リポジトリ内の DEVELOPERS.md。

---

すべての記述はリポジトリのREADMEから直接引用しています。追加機能は推測していません。