接入 MCP

极数本源 MCP 以源码包提供，由调用方在本机启动。Cursor、Codex 与 Claude Code 均通过本地命令连接，配置项为 command 与 args。本页为接入说明，不是 MCP 服务地址。

安装前检查

先检查本机环境，再决定是否安装。下列条件均已满足时，不要重新下载，不要重建虚拟环境，不要覆盖已有 .env，只核对客户端配置。

• 解压目录中已有 server.py，且 .venv 可以启动
• 该环境的 Python 为 3.10 至 3.13，依赖已经安装
• .env 中的 APIZERO_KEY 已填写，且不是示例占位
• 客户端配置的 command 指向该 Python，args 只含 server.py，没有网址

缺哪一项，只补哪一项。

获取源码

目录中还没有 server.py 时，再下载压缩包并解压。已有目录不要覆盖。压缩包仅供下载文件。

• server.py启动入口
• client.py请求接口
• catalog.py读取目录
• catalog.json在售接口目录
• selfcheck.py安装自检
• requirements.txt依赖
• pyproject.toml项目说明
• .env.example密钥示例
• README.md使用说明

安装依赖

虚拟环境已存在且依赖可用时，跳过本步。否则在解压目录执行。Python 版本为 3.10 至 3.13。macOS 与 Linux 将解释器换为 .venv/bin/python，复制示例文件使用 cp .env.example .env。

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

配置密钥

密钥已填写时不要改写。尚未填写时，编辑 .env，将 APIZERO_KEY 替换为控制台中的密钥。密钥不写入客户端配置。APIZERO_BASE为接口地址，与 MCP 连接方式无关。修改 .env 后需重新加载 MCP。

客户端配置

将示例路径替换为解压目录的绝对路径。command 为虚拟环境中的 Python，args 仅包含 server.py。保存后重新加载 MCP。

Cursor.cursor/mcp.json

可放在项目目录或用户目录。

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

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']

Claude Code.mcp.json

放在项目根目录。命令行可使用 claude mcp add --transport stdio apizero -- python绝对路径 server.py绝对路径。

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

调用说明

• apizero_search：按中文或接口 id 检索
• apizero_describe：读取参数。未经读取不得调用
• apizero_call：将字段放入 params 后调用
• apizero_account：查询当前 Key 的余额与额度，只读

调用顺序为检索、读取参数、再请求。实名、人脸、运营商与车主核验会产生费用，仅在明确要求核验且已提供姓名、证件号或车牌时继续。返回中的视频与音频地址保持原样。成功时 code 为 0；部分旧接口成功码为字符串 200。

社区说明