toon-parse-mcp

toon-parse MCP 服务

mcp-name: io.github.ankitpal181/toon-parse-mcp

一种专用的 Model Context Protocol (MCP) 服务，可通过将数据转换为 TOON（Token-Oriented Object Notation），并从代码文件中移除非必要上下文，来优化 token 使用量。

概述

toon-parse-mcp MCP 服务可帮助 AI Agent（例如 Cursor、Claude Desktop 等）更高效地工作，方式如下：

1. 优化代码上下文：移除代码文件中的注释和多余空格，同时保留功能结构和文档字符串。
2. 数据格式转换：将 JSON、XML、YAML 和 CSV 输入转换为紧凑的 TOON 格式，以节省 token。
3. 强制效率协议：内置资源，为大模型提供指令，要求其优先使用节省 token 的工具。

功能

工具

• optimize_input_context(raw_input: str)：处理原始文本数据（JSON/XML/CSV/YAML），并返回优化后的 TOON 格式。
• read_and_optimize_file(file_path: str)：读取本地代码文件，并返回 token 优化后的版本（不含行内注释，空白字符最少化）。

资源

• protocol://mandatory-efficiency：为大模型提供严格的系统指令提示词，确保其正确使用优化工具。

安装

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. 通过 Agent 面板右上角的“...”菜单打开 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“检查强制效率协议”，以查看效率协议。

测试

运行测试套件：

1. 安装测试依赖：

   pip install -e ".[test]"
   

2. 运行测试：

   pytest tests/
   

要求

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

许可证

MIT 许可证——详情请参阅 LICENSE。