智量通知识库

Appearance

安装 ​

装完这一页的四步，你会得到三样东西：能在 Python 里查数据的客户端、能让 AI 助手看懂用法的 skill、能让 AI 助手直接调数据的 MCP。建议全部装上，后面用 AI 查数据会方便很多。

只想在自己的代码里查数据、不打算用 AI 助手的话，做完第一、二步就够了。

开始之前 ​

确认电脑上有 Python，版本 3.10 或更高：

bash
python --version

显示 Python 3.10.x 及以上即可。低于 3.10 时客户端仍然能用（最低支持 3.9），但 MCP 装不了。没装过 Python 的话先去 python.org 下载安装，安装界面记得勾上 Add Python to PATH。

第一步：装三个第三方库 ​

bash
pip install pandas numpy pyarrow mcp --index-url https://pypi.tuna.tsinghua.edu.cn/simple

pandas 用来把查询结果变成 DataFrame，numpy 用来接收 format="npz" 的列式结果（取几十万行以上时快很多），pyarrow 用来接收 format="arrow" 的跨语言列式结果，mcp 是 AI 助手直连数据要用的协议库。这几个都是公共开源库，从清华镜像装最快，用不到的可以不装（pyarrow 体积较大）。

只取小批量数据、又不打算用 AI 助手的话，装 pandas 一个就够。

第二步：装客户端 ​

bash
pip install ZltFinOrmClient --index-url https://pypip.zltquant.com/

https://pypip.zltquant.com/ 是智量通的官方源，客户端只发布在这里，公共 pip 源上搜不到。

这个源只放智量通自己的包，没有 pandas、numpy、pyarrow、mcp 这些第三方库，所以第一步不能省，也不要把这个地址配成 pip 的全局 index-url。

装完验证一下：

bash
python -c "import zlt_finorm_client; print(zlt_finorm_client.__version__)"

打印出版本号就说明装好了。

要升级到最新版：

bash
pip install --upgrade ZltFinOrmClient --index-url https://pypip.zltquant.com/

第三步：装 AI skill ​

skill 是一份使用说明，装上之后 AI 助手就知道该按什么步骤查数据，不会凭空猜测数据目录。

bash
zltfinorm install-skill

默认会装到本机所有支持的 AI 助手，输出类似：

text
安装 skill 'zlt-finorm-client' (scope=user) →
  [ok] Claude Code: C:\Users\你\.claude\skills\zlt-finorm-client
  [ok] Codex CLI: C:\Users\你\.codex\skills\zlt-finorm-client
  [ok] Kimi CLI: C:\Users\你\.kimi\skills\zlt-finorm-client
  [skip] Qoder: 不支持 user 级文件安装（全局规则在 Settings GUI；项目级落 .qoder/rules）
  [ok] CodeBuddy: C:\Users\你\.codebuddy\rules\zlt-finorm-client.md

完成：4/5 个 Agent。

只想装到某一个助手，加 --agent：

bash
zltfinorm install-skill --agent claude

目前支持 claude、codex、kimi、qoder、codebuddy，后续会支持更多 Agent。

其他 Agent 可手动安装：将客户端的 zlt_finorm_client/skill/ 中的全部文件复制到对应 Agent 的技能目录。

Qoder 仅支持命令行安装到项目，使用 zltfinorm install-skill --agent qoder --scope project；全局规则需在 Qoder 设置中配置。

第四步：注册 MCP ​

skill 教 AI 怎么查，MCP 让 AI 直接查。有了 MCP，AI 助手不用写代码，直接就能拿到数据。

把 endpoint 和 token 换成客服给你的值：

bash
zltfinorm install-mcp --endpoint http://finorm.zltquant.com:7761 --token fk_你的token

注册完重启 AI 助手才会生效。在 Claude Code 里输入 /mcp，看到 finorm 已连接就成功了。

命令没生效时手动配 ​

各家 AI 助手的配置格式不统一，命令跑完没反应的话，可以照着下面手动写。

Claude Code、Qoder、CodeBuddy 用 JSON，改 ~/.claude.json 或者项目根目录的 .mcp.json：

json
{
  "mcpServers": {
    "finorm": {
      "command": "C:\\Users\\你\\miniconda3\\Scripts\\zltfinorm.exe",
      "args": ["mcp"],
      "env": {
        "FINORM_ENDPOINT": "http://finorm.zltquant.com:7761",
        "FINORM_TOKEN": "fk_你的token"
      }
    }
  }
}

Codex 用 TOML，改 ~/.codex/config.toml：

toml
[mcp_servers.finorm]
command = "C:\\Users\\你\\miniconda3\\Scripts\\zltfinorm.exe"
args = ["mcp"]

[mcp_servers.finorm.env]
FINORM_ENDPOINT = "http://finorm.zltquant.com:7761"
FINORM_TOKEN = "fk_你的token"

三个地方容易写错：

  1. command 必须写完整路径。 AI 助手启动时未必能找到 zltfinorm 命令，只写命令名会让服务悄无声息地起不来。用这条命令取准确路径：
    bash
    python -c "import sysconfig,os;print(os.path.join(sysconfig.get_path('scripts'),'zltfinorm.exe'))"
  2. Windows 路径里的反斜杠要写两遍（\\），或者干脆全换成正斜杠 /。
  3. token 前后不要留空格，也不要写成空字符串。

确认装好了 ​

bash
python -c "import zlt_finorm_client; print(zlt_finorm_client.__version__)"   # 客户端
zltfinorm list-agents                                                        # skill 支持的助手

AI 助手这边，重启后在 Claude Code 里输 /mcp 应该能看到 finorm。如果没看到，先在终端直接运行 zltfinorm mcp，正常情况下它会安静地等待输入而不是报错退出；有报错的话，错误信息会告诉你哪一步不对。

装好 skill 之后，在 AI 助手里提到「ZltFinOrmClient」「财经数据查询」这类字眼，它就会自动按正确方式来查。

卸载 ​

bash
zltfinorm uninstall-mcp        # 注销 MCP
zltfinorm uninstall-skill      # 卸载 skill
pip uninstall ZltFinOrmClient  # 卸载客户端

下一步 ​

装完就可以查数据了，去看示例，或者先翻翻数据范围有哪些数据。