端点转一次性CLI

要解决的问题

日常自动化里最常见的重复劳动，是给每个接口手写一层 shell 封装：解析鉴权、拼接查询、处理分页、转换输出格式，最后还要维护这层胶水代码。MCP server、OpenAPI spec、GraphQL endpoint 各有各的调用约定，agent 想真正跑起一个工具往往得先等人工写完 wrapper。这个技能把「读接口描述 → 生成可执行命令」这一步前移，让调用方直接面对一组能被发现、能被执行的命令，而不是一堆临时脚本。

它是怎么工作的

核心思路是把三类异构端点统一抽象成同一套 CLI 接口，再交给 shell 使用：

• MCP：支持 stdio 启动方式，例如 --mcp-stdio "node server.js"，进程生命周期与命令调用绑定。
• OpenAPI / GraphQL：直接吃 spec 或 endpoint 描述，自动推导可用操作与参数。
• 鉴权透传：通过 --env API_KEY=sk-... 注入凭据，OAuth 场景在三类模式下都开箱可用，不需要额外适配层。

调用方式是命令式而非配置式，配合 --help 就能完成命令发现，适合写进 pipeline 或 cron。

适用边界

• 它解决的是调用与发现，不替代接口本身的权限治理与审计。
• 需要目标端点可达，且鉴权凭据已就位。
• 依赖 Python 运行环境与 uv / uvx，首次拉取依赖需要网络。
• 生成的是一次性 CLI，适合自动化场景，不建议当作长期维护的对外工具壳。

一句话说，它把接口协议差异收敛到命令行边界内，让 agent 少写胶水、多做执行。