Toon Parse MCP

🚀 toon-parse MCP 服務器

toon-parse MCP 服務器是一款專門的 模型上下文協議 (MCP) 服務器，它通過將數據轉換為 TOON（面向令牌的對象表示法）並去除代碼文件中的非必要上下文，優化了令牌的使用。

🚀 快速開始

toon-parse-mcp MCP 服務器通過以下方式幫助 AI 代理（如 Cursor、Claude Desktop 等）更高效地運行：

1. 優化代碼上下文：在保留功能結構和文檔字符串的同時，去除代碼文件中的註釋和冗餘空格。
2. 數據格式轉換：將 JSON、XML、YAML 和 CSV 輸入轉換為緊湊的 TOON 格式，以節省令牌。
3. 強制效率協議：一個內置資源，指示大語言模型優先使用節省令牌的工具。

✨ 主要特性

工具

• optimize_input_context(raw_input: str)：處理原始文本數據（JSON/XML/CSV/YAML）並返回優化後的 TOON 格式。
• read_and_optimize_file(file_path: str)：讀取本地代碼文件並返回經過令牌優化的版本（無內聯註釋，最小化空格）。

資源

• protocol://mandatory-efficiency：為大語言模型提供嚴格的系統指令提示，以確保它們正確使用優化工具。

📦 安裝指南

pip install toon-parse-mcp

📚 詳細文檔

Cursor 配置

1. 打開 Cursor 設置 -> MCP。
2. 點擊“+ 添加新的 MCP 服務器”。
3. 名稱：toon-parse-mcp
4. 類型：command
5. 命令：python3 -m toon_parse_mcp.server（確保你的環境已激活，或使用 Python 的絕對路徑）

Windsurf 配置

1. 點擊 Cascade 工具欄中的錘子圖標並選擇“配置”。
2. 或者，直接編輯 ~/.codeium/windsurf/mcp_config.json。
3. 在 mcpServers 對象中添加以下內容：

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

Antigravity 配置

1. 通過代理面板右上角的“...”菜單打開 MCP 商店。
2. 選擇“管理 MCP 服務器” -> “查看原始配置”。
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 “檢查強制效率協議” 來引用效率協議。

🧪 測試

要運行測試套件，請按以下步驟操作：

1. 安裝測試依賴項：

pip install -e ".[test]"

2. 運行測試：

pytest tests/

📋 依賴要求

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

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。