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 文件。