如何让AI编码代理学会调用任意APImcp2cli技能接入Claude Code与Cursor完全指南【免费下载链接】mcp2cliTurn any MCP, OpenAPI, or GraphQL server into a CLI — at runtime, with zero codegen项目地址: https://gitcode.com/gh_mirrors/mc/mcp2cli你是否也遇到过这样的场景想让 AI 编码代理接入一个新 API却要先为它写 SDK 调用、读文档、反复试错mcp2cli是一个开源命令行工具能在运行时把任何 MCP 服务器、OpenAPI 规范或 GraphQL 端点直接变成 CLI零代码生成、零配置负担。配合一条技能安装命令它能让 Claude Code、Cursor 等 AI 编码代理自己发现并调用任意 API同时大幅节省每一轮对话中的 token 开销。 为什么用命令行调 APIAI 代理的三大痛点在 AI 编码代理的世界里调 API通常有两条路都不太顺手方案痛点写 SDK 代码每个 API 都要写胶水代码、管认证、处理分页代理还得学会你的私有封装注册 MCP 工具每个工具都要把完整的 JSON schema 塞进上下文工具一多 token 消耗爆炸mcp2cli 的思路很直接AI 代理天生就会用命令行。它把 API 翻译成一条一条的子命令--list列命令、--help看参数代理像使用git一样使用你的 API——需要时才查不需要的永远不占上下文。这也是它最大的卖点官方宣称在大型工具服务器上可节省 96–99% 的工具 schema token 开销。原理和架构可以在项目主文档 README.md 中读到更多细节。⚡ 三分钟快速上手安装 mcp2cli 并调用第一个 APImcp2cli 用 Python 编写要求 Python ≥ 3.10见 pyproject.toml无需编译安装# 方式一免安装直接运行推荐先试试 uvx mcp2cli --help # 方式二全局安装 pip install mcp2cli装好后先对任意一个 API 说列出来看看。以官方 OpenAPI 示例 Petstore 为例mcp2cli --spec https://petstore3.swagger.io/api/v3/openapi.json --list命令会自动从规范里动态生成每个端点的子命令调用时就像这样mcp2cli --spec https://petstore3.swagger.io/api/v3/openapi.json list-pets --status available支持四种来源一行命令切换--mcp URL— MCP 服务器HTTP/SSE--mcp-stdio 命令— 本地 MCP 服务器stdio 传输--spec URL或文件— OpenAPI 规范JSON/YAML--graphql URL— GraphQL 端点自动自省无需 SDL mcp2cli 如何接入 Claude Code 与 Cursor这一步才是让 AI 学会的关键。项目内置了一个可安装的技能文件 SKILL.md它用 frontmatter 声明了触发词——当你提到 mcp2cli、调用这个 MCP 服务器、从这个 API 创建一个技能 等表达时代理就会自动启用它。一行命令完成安装skills add由社区技能市场工具提供会自动放入代理的技能目录npx skills add knowsuchagency/mcp2cli --skill mcp2cli技能的核心工作流定义在 SKILL.md 的 Core Workflow 部分就四步连接 → 发现 → 检查 → 执行。安装后直接在对话里自然地说人话即可无需解释工具细节用 mcp2cli 连上https://mcp.example.com/sse看看它有哪些工具帮我从这个 OpenAPI 规范里列出所有可用操作调用create-task建一个任务标题是 Fix bugClaude Code 与 Cursor 读取技能目录的机制略有差异但都是把SKILL.md放进对应技能目录这一件事命令会自动处理路径。 四步核心工作流连接、发现、检查、执行技能教会代理的不是死记命令而是一套可迁移的方法连接Connect指定来源--mcp/--spec/--graphql/--mcp-stdio发现Discover--list看全部命令或用--search 关键词按名称/描述过滤检查Inspect命令 --help查看具体参数不必先记住任何东西执行Execute带上参数运行输出默认就是人类/LLM 可读的格式# 发现 mcp2cli --mcp https://mcp.example.com/sse --list # 检查 mcp2cli --mcp https://mcp.example.com/sse create-task --help # 执行 mcp2cli --mcp https://mcp.example.com/sse create-task --title Fix bug对代理来说这套流程的价值在于上下文按需付费一个 96 个工具的大服务器默认--list约 1400 tokens而--list --top 10 --compact只输出最常用的 10 个命令名约 20 tokens。 三个进阶技巧让代理调用更省更稳用 Bake 模式一行记住连接信息每次都要敲--spec加认证头很烦。Bake 模式把连接配置存成一个命名工具配置保存在~/.config/mcp2cli/baked.jsonmcp2cli bake create petstore --spec https://api.example.com/spec.json \ --exclude delete-*,update-* --methods GET,POST # 之后直接用 名字 调用无需任何连接参数 mcp2cli petstore list-pets --limit 10还支持--include/--exclude通配符过滤只暴露安全的操作给代理。详见 README.md 的 Bake mode 章节。内置 OAuthtoken 自动获取与刷新需要 OAuth 的 API 开箱即用--oauth走授权码 PKCE 流程自动开浏览器登录token 缓存在~/.cache/mcp2cli/oauth/并在过期时自动刷新后续调用无感知。无浏览器的 VPS/容器环境加--oauth-manual-callback复制粘贴授权 URL 即可。安全习惯密钥永远走环境变量技能文档 SKILL.md 的 Security 章节 明确要求敏感值一律用env:/file:前缀避免密钥出现在进程列表和 shell 历史里mcp2cli --mcp https://mcp.example.com/sse \ --auth-header Authorization:env:MY_API_TOKEN --list 高阶玩法让代理为任意 API 生成专属技能这是 mcp2cli 最有意思的能力代理可以基于 API 现场生成一个新技能。SKILL.md 里写好了完整的生成工作流生成工作流只需一句提示用 mcp2cli 为https://api.example.com/openapi.json创建一个技能代理会按固定流程自动完成发现所有命令--list检查每个命令的参数--help实测关键命令——探测大响应、日期格式、分页、报错质量等边缘情况Bake连接配置并安装 wrapper 脚本撰写 SKILL.md——包含决策清单、易踩的坑Anti-Patterns、输出处理技巧其中有个值得借鉴的设计叫Knowledge Delta 原则SKILL.md生成的技能文档不重复--help里已有的参数列表只记录只能通过实测和读文档才能学到的东西——哪些参数真正重要、哪些默认行为反直觉、哪些组合不工作。这正好治了代理技能文档越来越长却全是废话的顽疾。❓ 常见问题速查现象解法MCP 服务器连不上加--transport sse或--transport streamable强制指定传输方式命令列表是旧的加--refresh绕过缓存规范/工具列表默认缓存 1 小时响应太大撑爆上下文加--head 3只看前 3 条或用--toon输出比 JSON 省 40–60% token无浏览器的服务器上做 OAuth加--oauth-manual-callback把授权 URL 在任意设备打开后粘贴回终端需要机器可读输出加--json所有命令强制输出合法 JSON完整参数说明见 README.md 的 CLI reference。小结mcp2cli 给 AI 编码代理补上了最缺的一块拼图不必为每个 API 写代码命令线就是万能接口。安装、技能接入、发现调用三步走Claude Code 和 Cursor 就能像老练工程师一样调任何 MCP、OpenAPI、GraphQL 接口——还顺手帮你的 token 账单省了一大笔。核心源码实现约 4800 行兼容两代 MCP Python SDK都在 src/mcp2cli/init.py想深入原理或跑测试tests/ 覆盖了 bake、缓存、OAuth、GraphQL 等场景都可以直接查阅。【免费下载链接】mcp2cliTurn any MCP, OpenAPI, or GraphQL server into a CLI — at runtime, with zero codegen项目地址: https://gitcode.com/gh_mirrors/mc/mcp2cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/4 4:57:39 · 阅读 1.2k 如何让AI编码代理学会调用任意API：mcp2cli技能接入Claude Code与Cursor完全指南
如何让AI编码代理学会调用任意APImcp2cli技能接入Claude Code与Cursor完全指南【免费下载链接】mcp2cliTurn any MCP, OpenAPI, or GraphQL server into a CLI — at runtime, with zero codegen项目地址: https://gitcode.com/gh_mirrors/mc/mcp2cli你是否也遇到过这样的场景想让 AI 编码代理接入一个新 API却要先为它写 SDK 调用、读文档、反复试错mcp2cli是一个开源命令行工具能在运行时把任何 MCP 服务器、OpenAPI 规范或 GraphQL 端点直接变成 CLI零代码生成、零配置负担。配合一条技能安装命令它能让 Claude Code、Cursor 等 AI 编码代理自己发现并调用任意 API同时大幅节省每一轮对话中的 token 开销。 为什么用命令行调 APIAI 代理的三大痛点在 AI 编码代理的世界里调 API通常有两条路都不太顺手方案痛点写 SDK 代码每个 API 都要写胶水代码、管认证、处理分页代理还得学会你的私有封装注册 MCP 工具每个工具都要把完整的 JSON schema 塞进上下文工具一多 token 消耗爆炸mcp2cli 的思路很直接AI 代理天生就会用命令行。它把 API 翻译成一条一条的子命令--list列命令、--help看参数代理像使用git一样使用你的 API——需要时才查不需要的永远不占上下文。这也是它最大的卖点官方宣称在大型工具服务器上可节省 96–99% 的工具 schema token 开销。原理和架构可以在项目主文档 README.md 中读到更多细节。⚡ 三分钟快速上手安装 mcp2cli 并调用第一个 APImcp2cli 用 Python 编写要求 Python ≥ 3.10见 pyproject.toml无需编译安装# 方式一免安装直接运行推荐先试试 uvx mcp2cli --help # 方式二全局安装 pip install mcp2cli装好后先对任意一个 API 说列出来看看。以官方 OpenAPI 示例 Petstore 为例mcp2cli --spec https://petstore3.swagger.io/api/v3/openapi.json --list命令会自动从规范里动态生成每个端点的子命令调用时就像这样mcp2cli --spec https://petstore3.swagger.io/api/v3/openapi.json list-pets --status available支持四种来源一行命令切换--mcp URL— MCP 服务器HTTP/SSE--mcp-stdio 命令— 本地 MCP 服务器stdio 传输--spec URL或文件— OpenAPI 规范JSON/YAML--graphql URL— GraphQL 端点自动自省无需 SDL mcp2cli 如何接入 Claude Code 与 Cursor这一步才是让 AI 学会的关键。项目内置了一个可安装的技能文件 SKILL.md它用 frontmatter 声明了触发词——当你提到 mcp2cli、调用这个 MCP 服务器、从这个 API 创建一个技能 等表达时代理就会自动启用它。一行命令完成安装skills add由社区技能市场工具提供会自动放入代理的技能目录npx skills add knowsuchagency/mcp2cli --skill mcp2cli技能的核心工作流定义在 SKILL.md 的 Core Workflow 部分就四步连接 → 发现 → 检查 → 执行。安装后直接在对话里自然地说人话即可无需解释工具细节用 mcp2cli 连上https://mcp.example.com/sse看看它有哪些工具帮我从这个 OpenAPI 规范里列出所有可用操作调用create-task建一个任务标题是 Fix bugClaude Code 与 Cursor 读取技能目录的机制略有差异但都是把SKILL.md放进对应技能目录这一件事命令会自动处理路径。 四步核心工作流连接、发现、检查、执行技能教会代理的不是死记命令而是一套可迁移的方法连接Connect指定来源--mcp/--spec/--graphql/--mcp-stdio发现Discover--list看全部命令或用--search 关键词按名称/描述过滤检查Inspect命令 --help查看具体参数不必先记住任何东西执行Execute带上参数运行输出默认就是人类/LLM 可读的格式# 发现 mcp2cli --mcp https://mcp.example.com/sse --list # 检查 mcp2cli --mcp https://mcp.example.com/sse create-task --help # 执行 mcp2cli --mcp https://mcp.example.com/sse create-task --title Fix bug对代理来说这套流程的价值在于上下文按需付费一个 96 个工具的大服务器默认--list约 1400 tokens而--list --top 10 --compact只输出最常用的 10 个命令名约 20 tokens。 三个进阶技巧让代理调用更省更稳用 Bake 模式一行记住连接信息每次都要敲--spec加认证头很烦。Bake 模式把连接配置存成一个命名工具配置保存在~/.config/mcp2cli/baked.jsonmcp2cli bake create petstore --spec https://api.example.com/spec.json \ --exclude delete-*,update-* --methods GET,POST # 之后直接用 名字 调用无需任何连接参数 mcp2cli petstore list-pets --limit 10还支持--include/--exclude通配符过滤只暴露安全的操作给代理。详见 README.md 的 Bake mode 章节。内置 OAuthtoken 自动获取与刷新需要 OAuth 的 API 开箱即用--oauth走授权码 PKCE 流程自动开浏览器登录token 缓存在~/.cache/mcp2cli/oauth/并在过期时自动刷新后续调用无感知。无浏览器的 VPS/容器环境加--oauth-manual-callback复制粘贴授权 URL 即可。安全习惯密钥永远走环境变量技能文档 SKILL.md 的 Security 章节 明确要求敏感值一律用env:/file:前缀避免密钥出现在进程列表和 shell 历史里mcp2cli --mcp https://mcp.example.com/sse \ --auth-header Authorization:env:MY_API_TOKEN --list 高阶玩法让代理为任意 API 生成专属技能这是 mcp2cli 最有意思的能力代理可以基于 API 现场生成一个新技能。SKILL.md 里写好了完整的生成工作流生成工作流只需一句提示用 mcp2cli 为https://api.example.com/openapi.json创建一个技能代理会按固定流程自动完成发现所有命令--list检查每个命令的参数--help实测关键命令——探测大响应、日期格式、分页、报错质量等边缘情况Bake连接配置并安装 wrapper 脚本撰写 SKILL.md——包含决策清单、易踩的坑Anti-Patterns、输出处理技巧其中有个值得借鉴的设计叫Knowledge Delta 原则SKILL.md生成的技能文档不重复--help里已有的参数列表只记录只能通过实测和读文档才能学到的东西——哪些参数真正重要、哪些默认行为反直觉、哪些组合不工作。这正好治了代理技能文档越来越长却全是废话的顽疾。❓ 常见问题速查现象解法MCP 服务器连不上加--transport sse或--transport streamable强制指定传输方式命令列表是旧的加--refresh绕过缓存规范/工具列表默认缓存 1 小时响应太大撑爆上下文加--head 3只看前 3 条或用--toon输出比 JSON 省 40–60% token无浏览器的服务器上做 OAuth加--oauth-manual-callback把授权 URL 在任意设备打开后粘贴回终端需要机器可读输出加--json所有命令强制输出合法 JSON完整参数说明见 README.md 的 CLI reference。小结mcp2cli 给 AI 编码代理补上了最缺的一块拼图不必为每个 API 写代码命令线就是万能接口。安装、技能接入、发现调用三步走Claude Code 和 Cursor 就能像老练工程师一样调任何 MCP、OpenAPI、GraphQL 接口——还顺手帮你的 token 账单省了一大笔。核心源码实现约 4800 行兼容两代 MCP Python SDK都在 src/mcp2cli/init.py想深入原理或跑测试tests/ 覆盖了 bake、缓存、OAuth、GraphQL 等场景都可以直接查阅。【免费下载链接】mcp2cliTurn any MCP, OpenAPI, or GraphQL server into a CLI — at runtime, with zero codegen项目地址: https://gitcode.com/gh_mirrors/mc/mcp2cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考