mcp2cli 深度研究报告

📋 项目概述

🎯 解决的问题：MCP Token 膨胀

原生 MCP 的问题

每个 MCP 服务器在每次交互中都会将其完整的工具架构注入上下文：

• 30 个工具 ≈ 3,600 tokens/次
• 120 个工具 × 25 次交互 = 362,000 tokens（仅架构部分）

mcp2cli 的解决方案

通过按需发现工具，大幅减少 Token 消耗：

节省效果：使用 cl100k_base 测量，30 个工具 15 次交互节省 96%，120 个工具 25 次交互节省 99%。

🚀 使用方法

基本用法

# 列出所有可用工具（约16 tokens/工具）
mcp2cli --mcp https://mcp.example.com/sse --list

# 查看具体工具帮助（约120 tokens，仅一次）
mcp2cli --mcp https://mcp.example.com/sse create-task --help

# 执行工具
mcp2cli --mcp https://mcp.example.com/sse create-task --title "修复bug"

支持的数据源

• MCP 服务器：SSE 或 stdio 传输
• OpenAPI 规范：JSON/YAML 格式，本地或远程 URL

🔧 核心特性

📦 安装方式

方式一：npx 直接运行

npx github:knowsuchagency/mcp2cli --mcp <server> --list

方式二：作为 Claude Code/Cursor 技能安装

npx skills add knowsuchagency/mcp2cli --skill mcp2cli

方式三：Python 安装

pip install mcp2cli

🏗️ 架构设计

工作流程

┌─────────────────────────────────────────────────────────────┐
│  输入: MCP Server URL / OpenAPI Spec                        │
│       ↓                                                     │
│  运行时解析工具架构                                          │
│       ↓                                                     │
│  动态生成 CLI 接口 (--list, --help, <command>)              │
│       ↓                                                     │
│  LLM 按需发现工具 → 调用 → 执行                             │
└─────────────────────────────────────────────────────────────┘

与原生 MCP 对比

💡 核心价值

1. 极致 Token 效率 - 96-99% 的 Token 节省，降低 API 成本
2. 无感知迁移 - 现有 MCP 服务器无需任何改动
3. 动态适应 - 服务端变更无需客户端重建
4. 双重支持 - 同时支持 MCP 和 OpenAPI 生态
5. LLM 通用 - 不绑定特定模型，任何支持工具调用的 LLM 都可用

🌍 社区反响

• HackerNews 热门项目（Show HN）
• 被多个 MCP CLI 工具列表收录
• 作者表示灵感来自 Kagan Yilmaz 对 CLI vs MCP 的分析及 CLIHub

相关同类工具

社区已出现约 100+ 个 MCP CLI 工具，包括：

• chrishayuk/mcp-cli
• wong2/mcp-cli
• f/mcptools
• adhikasp/mcp-client-cli
• thellimist/clihub
• philschmid/mcp-cli

mcp2cli 的差异化：

• 支持 OpenAPI（多数不支持）
• 动态 CLI 生成（无需重新编译）
• 可作为 AI Agent 技能安装

📚 相关资源

• GitHub: https://github.com/knowsuchagency/mcp2cli
• HackerNews 讨论: Show HN: Mcp2cli – One CLI for every API
• 灵感来源: CLIHub by thellimist

#记忆 #mcp2cli #MCP #OpenAPI #CLI #Token优化 #AI工具