Back to notes

knowsuchagency/mcp2cli

AI summary · Qwen Summary in Chinese Indexed
Original source

mcp2cli 是一个运行时将 MCP、OpenAPI 和 GraphQL 接口转换为 CLI 的工具，支持 OAuth、缓存、Bake 配置和面向 LLM 的 JSON/TOON 输出。

核心功能

  • mcp2cli 可在运行时将 MCP 服务器、OpenAPI 规范或 GraphQL 端点转换为 CLI，无需代码生成。
  • 页面称其可减少每轮工具 schema 带来的 96–99% token 浪费。

安装与代理技能

  • 可通过 uvx mcp2cli --help 直接运行，或用 uv tool install mcp2cli 全局安装。
  • 提供可安装技能，帮助 Claude Code、Cursor、Codex 等 AI 编码代理发现并调用 MCP 或 OpenAPI 端点。

多协议调用

  • 支持 --mcp、--mcp-stdio、--spec 和 --graphql 等模式列出并调用工具或端点。
  • 提供 --search、--auth-header、--transport、--env、--root 和 --complete 等选项。

OAuth 与凭据

  • 内置 OAuth 支持，覆盖 MCP、OpenAPI 和 GraphQL 模式，并自动处理令牌获取、缓存和刷新。
  • 敏感值支持 env: 和 file: 前缀，避免将密钥作为命令行参数暴露。

Bake 与输出控制

  • bake 模式可将连接配置保存为命名工具，支持 include/exclude/methods 过滤和 @NAME 调用。
  • --json 强制所有命令输出有效 JSON，--toon 提供面向 LLM 的 token 高效编码。

缓存与兼容性

  • 规范和 MCP 工具列表默认缓存在 ~/.cache/mcp2cli/，TTL 为 1 小时，本地文件规范不缓存。
  • 兼容 MCP Python SDK 的 1.x 和 2.x 主要版本，声明依赖为 mcp>=1.26,<3。