# 极数本源 MCP

这是跑在你自己电脑上的源码。编辑器通过本机命令启动 `server.py`，配置里不要填写网址。

压缩包里有：

- `server.py`：启动入口
- `client.py`：请求 v1 接口
- `catalog.py`、`catalog.json`：在售接口目录
- `selfcheck.py`：不联网的自检
- `requirements.txt`、`pyproject.toml`
- `.env.example`

`.env` 里的 `APIZERO_BASE` 是普通接口地址，不是 MCP 地址。

## 安装前检查

先检查，再安装。下面都已经满足时，不要重新下载，不要重建虚拟环境，不要覆盖 `.env`。

- 目录里已有 `server.py`，`.venv` 可以启动
- 该环境的 Python 是 3.10 到 3.13，依赖已经装好
- `.env` 里的 `APIZERO_KEY` 已填写，且不是示例占位
- 客户端配置的 `command` 指向这个 Python，`args` 只含 `server.py`，没有网址

缺哪一项，只补哪一项。

## 安装

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

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

macOS 和 Linux：

```bash
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
cp .env.example .env
```

打开 `.env`，把 `APIZERO_KEY` 换成控制台里的密钥。不要把密钥写进编辑器配置，也不要贴进对话。

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

## 四个工具

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

直接说要查什么。先检索，再读参数，再调用。查余额用 `apizero_account`。

实名、人脸、运营商、车主核验会扣费。只有你明确要核验，并且姓名、证件号或车牌是你这次提供的，才继续。

返回里的视频和音频地址保持原样。

成功时 `code` 为 `0`。一批旧接口成功码是字符串 `200`。失败时看 `msg` 和 `request_id`。