Toon Parse MCP

🚀 toon-parse MCP Server

専用のモデルコンテキストプロトコル (MCP)サーバーで、データをTOON (Token-Oriented Object Notation)に変換し、コードファイルから不要なコンテキストを削除することで、トークンの使用を最適化します。

🚀 クイックスタート

toon-parse-mcp MCPサーバーは、AIエージェント（Cursor、Claude Desktopなど）がより効率的に動作するのを支援します。

1. コードコンテキストの最適化：コードファイルからコメントと冗長な空白を削除し、機能構造とドキュメント文字列を保持します。
2. データ形式の変換：JSON、XML、YAML、およびCSV入力をコンパクトなTOON形式に変換して、トークンを節約します。
3. 必須効率プロトコル：LLMにトークン節約ツールを優先的に使用するよう指示する組み込みリソースです。

✨ 主な機能

ツール

• optimize_input_context(raw_input: str)：生のテキストデータ（JSON/XML/CSV/YAML）を処理し、最適化されたTOON形式を返します。
• read_and_optimize_file(file_path: str)：ローカルのコードファイルを読み取り、トークンが最適化されたバージョン（インラインコメントなし、空白を最小化）を返します。

リソース

• protocol://mandatory-efficiency：LLMに最適化ツールを正しく使用することを保証するための厳格なシステム指示プロンプトを提供します。

📦 インストール

pip install toon-parse-mcp

📚 ドキュメント

Cursor

1. Cursorの設定 -> MCPを開きます。
2. "+ Add New MCP Server"をクリックします。
3. 名前: toon-parse-mcp
4. タイプ: command
5. コマンド: python3 -m toon_parse_mcp.server（環境がアクティブであることを確認するか、Pythonの絶対パスを使用してください）

Windsurf

1. Cascadeツールバーのハンマーアイコンをクリックし、「Configure」を選択します。
2. または、直接 ~/.codeium/windsurf/mcp_config.json を編集します。
3. mcpServers オブジェクトに以下を追加します。

{
  "mcpServers": {
    "toon-parse-mcp": {
      "command": "python3",
      "args": ["-m", "toon_parse_mcp.server"]
    }
  }
}

Antigravity

1. エージェントパネルの右上にある「...」メニューからMCPストアを開きます。
2. 「Manage MCP Servers」 -> 「View raw config」を選択します。
3. または、直接 ~/.gemini/antigravity/mcp_config.json を編集します。
4. mcpServers オブジェクトに以下を追加します。

{
  "mcpServers": {
    "toon-parse-mcp": {
      "command": "python3",
      "args": ["-m", "toon_parse_mcp.server"]
    }
  }
}

Claude Desktop

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "toon-parse-mcp": {
      "command": "python3",
      "args": ["-m", "toon_parse_mcp.server"]
    }
  }
}

💻 使用例

サーバーがアクティブなとき、AIは optimize_input_context と read_and_optimize_file ツールにアクセスできます。また、AIに「check the mandatory efficiency protocol」と尋ねることで、効率プロトコルを参照することもできます。

テストの実行

テストスイートを実行するには：

1. テスト依存関係をインストールします。

   pip install -e ".[test]"
   

2. テストを実行します。

   pytest tests/
   

必要要件

• Python >= 3.10
• mcp >= 1.25.0
• toon-parse >= 2.4.3

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。