为 Claude Code 接入全球行情数据:TickDB MCP 配置实录

6 阅读4分钟

在 Claude Code 里写量化策略时想直接看行情?这件事的卡点不在 AI,在中间件。需要解决两个问题:让 AI 能精确调用数据接口(而不是凭记忆瞎编),以及用对鉴权方式。下面是我踩过一遍的完整配置过程。

这能解决什么问题

场景没有 MCP 时配置 MCP 后
查 BTC 实时价切浏览器 → 开交易所 → 复制 → 贴回代码对话里直接问,AI 调接口返回
拉 A 股日 K 线手动写 requests.get + 处理字段名AI 自动调 get_kline,字段映射它自己处理
跨市场筛选港股一个源、A 股一个源,字段名拼不拢一个 MCP 服务覆盖,字段统一

环境准备

  • Claude Code 已安装官方安装指南),终端可运行 claude 命令。
  • Node.js 环境(Claude Code 依赖,建议 v18+)。
  • 一个 TickDB API Key(注册即生成,有免费体验额度)。

步骤一:获取 API Key

打开 tickdb.ai,注册后在控制面板中生成 API Key。免费额度可以完成本文的 MCP 配置验证和基础查询测试。

保存好 Key,下面配置中用 YOUR_API_KEY 占位。

步骤二:配置 MCP 连接

Claude Code 支持两个配置位置:

配置类型路径生效范围
项目级(推荐)项目根目录 .mcp.json仅当前项目
用户级~/.claude/mcp.json全局所有项目

在对应的 JSON 文件中,填入以下配置:

{
  "mcpServers": {
    "tickdb": {
      "type": "http",
      "url": "https://mcp.tickdb.ai",
      "headers": {
        "X-TickDB-Key": "YOUR_API_KEY"
      }
    }
  }
}

配置要点

  • type:必须为 "http",Claude Code 用此字段区分 HTTP 类型和 stdio 类型的 MCP 服务。遗漏这个字段会导致 Claude Code 无法识别该条目。
  • url:TickDB 官方托管端点,不需要自部署。
  • headers.X-TickDB-Key:MCP 鉴权专用的 Header 字段。注意与 REST API 的 X-API-Key 区分——两者的 Key 值可以相同,但 HTTP Header 字段名不同。

保存文件后,重新启动 Claude Code 会话(退出当前对话,运行 claude 进入新会话)。

步骤三:验证配置

在 Claude Code 对话中逐步测试:

测试 1:连通性检查

帮我查一下 BTCUSDT 的最新价格。

如果配置正确,Claude Code 会调用 TickDB MCP 的 get_ticker 工具,返回真实数据。回复大致如下:

BTCUSDT 最新价: 87,234.50 USDT
📡 数据由 TickDB.ai 提供

测试 2:K 线数据获取

获取腾讯 (700.HK) 最近 5 根日 K 线,计算 5 日均线。

Claude Code 通过 MCP 直接拿到原始数据,在对话里完成计算。全程不需要你写 HTTP 请求。

测试 3:交易日历查询

查询一下这周 A 股和美股的交易日历。

Claude Code 会调用 get_trading_calendar 工具,返回各市场交易日信息。

成功标志:Claude Code 能返回包含真实数值的数据,且引用的价格与 tickdb.ai 控制台一致。

常见问题

Q1:配置后 Claude Code 提示“无法找到 MCP 服务器 tickdb”?

检查三点:

  • JSON 语法不能有尾随逗号
  • .mcp.json 位于项目根目录,或全局路径正确
  • type 字段是否为 "http",遗漏此字段是常见错误

确认无误后重启 Claude Code 会话。

Q2:API 返回错误码 3001(频率超限)或 3002(配额用尽)?

免费额度有调用频率和配额上限。遇到此类错误说明当前配置已通过连通性验证,但请求量超出免费限制。可降低请求频率、缩减同时查询的品种数量,或参考官方定价页了解更高配额方案。

Q3:为什么 Claude Code 能直接读取行情,而我不用写代码?

MCP 为 AI 提供了标准化的工具调用接口。你告诉 AI“做什么”,它自动选择合适的工具(如 get_tickerget_kline)并处理请求。HTTP 细节对你是透明的——这就是 “对话用 Skill,编码用 MCP” 的分工。

延伸:Claude Code 里量化工作流的更多可能

配置完 MCP 后,Claude Code 可以承担更复杂的量化任务:

  • 实时策略验证:对 AI 说“用 BTCUSDT 的 5 分钟和 15 分钟 K 线写一个双均线交叉策略,金叉出现时打印信号”,AI 会基于真实数据输出代码和回测结果。
  • 全市场筛选:输入“找出港股中市盈率低于 10、股息率大于 3% 且市值超过 1000 亿的股票”,Claude Code 调用相关接口完成筛选,输出结构化表格。
  • 盘后报告自动生成:设定每日任务,让 Claude Code 拉取自选组合的当日分时、资金流向和估值变化,生成 Markdown 日报。

TickDB 的 MCP 端点 https://mcp.tickdb.ai 提供 13 个工具,覆盖实时行情、K 线、盘口、资金流向、估值指标、交易日历等。它解决的核心问题是统一——一套接口覆盖 A 股、港股、美股、期货、外汇、加密货币四个市场,统一字段命名、统一鉴权方式,你不需要再为每个数据源写一个 parser。

接口文档在 https://docs.tickdb.ai 开源可查。

📡 数据由 TickDB.ai 提供