本机接入 MCP：Cursor、Codex 与 Claude Code

极数本源的 MCP 跑在你自己的电脑上。下载源码，用 Python 启动，编辑器通过本机命令连接。配置里只写 command 和 args，不要填写网址。

说明页是 https://apizero.cn/mcp 。源码压缩包是 https://apizero.cn/downloads/apizero-mcp.zip 。这两个地址都是网页和文件，不能填进 MCP 的 url。.env 里的 APIZERO_BASE 是普通接口地址，和 MCP 怎么连接无关。

压缩包里有什么

server.py 是启动入口。client.py 负责请求接口。catalog.py 和 catalog.json 是在售接口目录。selfcheck.py 做不联网自检。密钥写在同目录的 .env，变量名 APIZERO_KEY。不要把密钥写进编辑器配置，也不要贴进对话。

安装

使用 Python 3.10 到 3.13。解压后在该目录执行：

python -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt
copy .env.example .env

macOS 和 Linux 把 Python 换成 .venv/bin/python，复制示例文件用 cp .env.example .env。打开 .env，把 APIZERO_KEY 换成控制台里的密钥。

下面配置里的路径改成你解压后的绝对路径。command 用装过依赖的那个 Python，args 只放 server.py。

Cursor

在项目里新建 .cursor/mcp.json：

{
  "mcpServers": {
    "apizero": {
      "command": "C:\\path\\apizero-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\apizero-mcp\\server.py"
      ]
    }
  }
}

macOS 和 Linux 的 command 用 .venv/bin/python 的绝对路径。保存后重载 MCP。改过 .env 也要重载一次。

Codex

写在用户目录的 .codex/config.toml。Windows 是 %USERPROFILE%\.codex\config.toml。只用 command，不要写 url。

[mcp_servers.apizero]
command = 'C:\path\apizero-mcp\.venv\Scripts\python.exe'
args = ['C:\path\apizero-mcp\server.py']

也可以执行：

codex mcp add apizero -- 你的python绝对路径 server.py的绝对路径

Claude Code

在项目根新建 .mcp.json：

{
  "mcpServers": {
    "apizero": {
      "type": "stdio",
      "command": "C:\\path\\apizero-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\apizero-mcp\\server.py"
      ]
    }
  }
}

命令行：

claude mcp add --transport stdio apizero -- 你的python绝对路径 server.py的绝对路径

四个工具

• apizero_search：用中文或接口 id 查找
• apizero_describe：读参数。没读过不要调用
• apizero_call：把字段放进 params 再调用
• apizero_account：看当前 Key 的余额和额度，只读，不计费

直接说要查什么。先检索，再读参数，再调用。例如查天气会落到 weather，字段以 describe 为准。

实名、人脸、运营商、车主核验会扣费。只有你明确要核验，并且姓名、证件号或车牌是你这次提供的，才继续。返回里的视频和音频地址保持原样。

成功时 code 为 0。一批旧接口成功码是字符串 200。失败时看 msg 和 request_id，不要换一套参数盲重试。