knowsuchagency/mcp2cli

Turn any MCP, OpenAPI, or GraphQL server into a CLI — at runtime, with zero codegen

解决的问题

mcp2cli 消除了在想要通过命令行界面与 API 交互时,需要手动生成代码或编写自定义包装器的需求。它专门针对 AI 代理的“token 浪费”问题;代理无需在每一轮都将大量工具架构传递给 LLM,而是可以使用此 CLI 动态发现和调用工具,大幅减少 token 消耗。

工作原理

该工具作为运行时桥接器,检查各种 API 定义并将其转换为可执行的 CLI 命令,无需任何构建步骤。它支持四种主要来源:

  • MCP 服务器:通过 HTTP/SSE 或 stdio 传输连接。
  • OpenAPI 规范:解析 JSON 或 YAML 规范以生成命令。
  • GraphQL 端点:检查端点以自动生成查询和变更。
  • 本地/远程文件:可从 URL 或本地路径读取规范。

它包含“Bake”模式,可将复杂的连接和认证设置保存为命名配置,让用户可以使用简单的 @name 前缀调用它们。它还会在本地跟踪工具使用情况,以对最常用的工具进行排名,帮助 LLM 用更少的 token 更快找到正确的工具。

适用对象

  • AI 代理开发者:使用代理(如 Claude Code 或 Cursor)的人,希望让代理能够与任何 API 交互,而不会让上下文窗口膨胀。
  • 高级用户/DevOps:需要从终端快速、统一地与多种不同 API 标准(MCP、OpenAPI、GraphQL)交互的人。

亮点

  • 零代码生成:在运行时将 API 转换为 CLI。
  • 广泛兼容性:支持 MCP(HTTP/SSE/stdio)、OpenAPI 和 GraphQL。
  • Token 效率:具备使用感知的工具排名和“TOON”编码,以最小化 LLM token 成本。
  • 强大的认证:内置 OAuth 支持(包括 PKCE 和适用于无头主机的手动回调)以及通过环境变量或文件进行秘密管理。
  • Bake 模式:保存连接设置以创建持久、命名的 CLI 包装器。

相关

  • 项目
  • 项目
  • 项目
  • Dispatch
  • 项目