零代码改动！把 Python CLI 变成 AI Agent 工具只要一行命令

痛点：你的 Python CLI 工具，AI 根本调用不了

写了一个很牛的 Python CLI 工具（用 Click 或 typer 做的），想让它被 AI Agent 直接调用——结果发现 AI 只能调 API、发 HTTP 请求，根本不知道你这个 CLI 存在。

这时候你有两个选择：

• 给 AI 写一长串 prompt，让它记住你 CLI 的用法和参数格式（脆弱、易错）
• 自己写一个 MCP Server 来包装它（好，但又要写一堆代码）

有没有更简单的方式？

click-to-mcp：零改动，CLI 直接变 MCP Server

click-to-mcp 做了一件很聪明的事：它读取你的 Click/typer CLI 定义（命令、参数、类型、help 文本），自动生成 MCP tool，无需任何代码修改。

简单说：你不用写任何 MCP 代码，只要一行命令，CLI 就变成了 AI 能直接调用的工具。

怎么工作的

Click/typer 本身已经有完整的结构化接口定义——命令名称、参数、类型、默认值、help 文本。click-to-mcp 读取这些元数据，动态生成 JSON Schema，然后暴露为 MCP tools。

参数类型自动映射：

• click.STRING → string
• click.INT → integer
• click.BOOL → boolean
• click.Choice → string + enum

快速上手

安装：

pip install click-to-mcp

发现系统中的 Click/typer CLI：

click-to-mcp discover

把某个 CLI 暴露为 MCP Server：

click-to-mcp serve mypackage.cli:main

HTTP+SSE 方式（远程访问）：

pip install "click-to-mcp[http]"
click-to-mcp serve-http mypackage.cli:main --port 8000

真实场景举例

假设你用 typer 写了一个 API Contract Guardian CLI：

@app.command()
def validate(spec_file: str, base_url: str, strict: bool = False):
    """Validate API contract."""
    ...

用 click-to-mcp 包装后，AI Agent 直接调用：

acg_validate({
  spec_file: "openapi.yaml",
  base_url: "https://staging.api.com",
  strict: true
})

AI 不需要知道什么命令行参数、flag、语法——结构化调用，AI 最擅长的方式。

支持哪些 AI 工具

Claude Code、Codex CLI、Cursor、VS Code、Windsurf、Cline 等所有支持 MCP 协议的工具都行。

生成的 MCP Server 支持两种传输方式：

• stdio：本地 AI 客户端（Claude Code、Cursor）
• HTTP+SSE：远程访问、多用户场景（v0.3.0+）

为什么这个 Skill 值得收藏

CLI 工具是开发者工作流的核心，但它们和 AI Agent 之间隔着一层。click-to-mcp 用零代码改动的思路，直接打通这层壁垒——不用写 MCP Server，不用改现有 CLI，只要 pip install 就能让 AI 用上你的工具。

如果你团队有自己维护的 Python CLI 工具，想让 AI Agent 也能调用它来自动化工作流，这个 Skill 几乎是开箱即用的解法。

GitHub： https://github.com/Coding-Dev-Tools/click-to-mcp

GitHub: https://github.com/Coding-Dev-Tools/click-to-mcp