综合

Claude Code 接入实时行情：MCP 配置从零到一

作者: TickDB Research · 发布: 2026/5/14 · 阅读: 14

标签: Track A, 今日头条, 教程型文章

你想在 Claude Code 里一边写量化策略，一边让 AI 直接拉取 BTC 的实时K线、A股的资金流向或美股的市盈率吗？通过 TickDB 的 MCP（Model Context Protocol）服务，只需一次简单配置，Claude Code 就能化身你的专属行情终端。本教程手把手带你完成全部步骤，代码可直接运行，配置立即可用。

环境准备

开始前，确保你已具备：

  • Claude Code 已安装（官方安装指南），终端可运行 claude 命令。
  • Node.js 环境（Claude Code 依赖，建议 v18+）。
  • 一个 TickDB API Key（没有的话，马上就能免费申请）。

步骤一：获取 TickDB API Key

打开 tickdb.ai，点击“免费开始”或“注册”，使用邮箱和密码完成注册。登录后，在控制面板中生成一个 API Key。

费用说明：有免费体验额度，注册即可开始，无需绑定信用卡。免费额度足够你玩转本文所有示例。

请保存好你的 Key，它长这样：ZolsmxPs...qPy（下面配置中统一使用 YOUR_API_KEY 占位）。

步骤二：配置 MCP 连接

Claude Code 支持通过 JSON 文件配置 MCP 服务器。你可以在两个位置选择其一：

  • 项目级配置（推荐）：在项目根目录创建 .mcp.json，仅当前项目可用。
  • 用户级配置：在 ~/.claude/mcp.json（Linux/macOS）或 %USERPROFILE%\.claude\mcp.json（Windows），全局生效。

在对应的 JSON 文件中，填入以下完整配置：

{
  "mcpServers": {
    "tickdb": {
      "url": "https://mcp.tickdb.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

配置说明：

  • mcpServers：MCP 服务列表，键名 tickdb 可自定义，之后在 Claude Code 中引用。
  • url：TickDB 官方托管的 MCP 端点，无需自部署。
  • headers：鉴权方式，必须使用 Authorization 头并携带 Bearer YOUR_API_KEY。这与 TickDB REST API 的 X-API-Key 不同，务必区分。

保存文件后，重新启动 Claude Code 会话（在终端中运行 claude 进入新的对话）。

步骤三：验证连接成功

也可以直接用 Python 快速验证 API Key 是否有效：

import requests

headers = {"X-API-Key": "YOUR_API_KEY"}
resp = requests.get(
    "https://api.tickdb.ai/v1/market/ticker?symbols=BTCUSDT",
    headers=headers
)
print(resp.json())  # code=0 即连通成功

在 Claude Code 对话中，直接输入以下自然语言命令，观察 AI 是否能返回准确数据：

测试 1：查询实时价格

帮我查一下 BTCUSDT 和 AAPL.US 的最新价格。

如果配置正确，Claude Code 会调用 TickDB 提供的 13 个 MCP 工具（包括 Ticker、K线、盘口等），自动获取数据并回复，效果如下：

BTCUSDT 最新价: 87,234.50 USDT，24h跌幅 -1.2%
AAPL.US 最新价: 198.75 USD，24h涨幅 +0.8%
📡 数据由 TickDB.ai 提供

测试 2：获取历史K线数据

获取腾讯 (700.HK) 最近 5 根日K线，并计算简单的 5 日均线。

Claude Code 会通过 MCP 直接拿到原始数据，在对话里完成计算并返回结果，全程无需你写一行 HTTP 请求代码。

测试 3：查看股票基本面

对比微软 (MSFT.US) 和谷歌 (GOOGL.US) 的市盈率、市净率和总市值。

AI 将自动调用 TickDB 的股票信息与市场指标接口，给出结构化的对比表格。这些接口覆盖了美股、港股、A股的完整基本面数据。

成功标志：Claude Code 能返回包含真实数值的行情数据，且 AI 回复中引用的价格与 tickdb.ai 控制台实时显示一致。

常见问题

1. 配置后 Claude Code 提示“无法找到 MCP 服务器 tickdb”怎么办？

检查 JSON 文件路径和格式是否正确。特别注意：

  • .mcp.json 必须位于项目根目录（或正确的全局路径）。
  • JSON 语法不能有尾随逗号，Authorization 的值必须为 "Bearer " + 空格 + Key。
  • 重新启动 Claude Code 会话（完全退出并重新运行 claude）。

2. API 返回错误码 3001（频率超限）或 3002（配额用尽）怎么办？

免费额度有调用频率和配额限制。如果遇到此类错误，AI 会根据错误码自动提示你升级。你可以前往 tickdb.ai 查看更高级的订阅计划，获取更高配额。

3. 为什么 Claude Code 能直接读取行情，而我不用写代码？

这就是 MCP 的核心价值——它为 AI 提供了一个标准化的工具调用接口。你只需要告诉 AI “做什么”，它会自动选择合适的工具（例如 get_ticker）并处理请求，你完全不用关心 HTTP 细节。这正是 “对话用 Skill，编码用 MCP” 的体现。

延伸：Claude Code 量化工作流实战

有了 MCP 行情支持，你的 Claude Code 可以变成强大的量化工作站：

  • 实时策略调试：对 AI 说“写一个双均线交叉策略，用 BTCUSDT 的 5m 和 15m 实时K线进行模拟，当金叉出现时打印信号”，AI 会直接基于真实数据输出代码和结果。
  • 全市场筛选：输入“找出港股中市盈率低于 10、股息率大于 3% 且市值超过 1000 亿的股票”，Claude Code 调用 TickDB 的股票信息和市场指标接口，几分钟内完成筛选。
  • 盘后报告自动生成：设定每日定时任务，让 Claude Code 拉取你自选组合（如 AAPL.US, 700.HK, 600519.SH）的当日分时数据、资金流向和估值变化，生成 Markdown 日报。

TickDB 的 MCP 端点 https://mcp.tickdb.ai 提供了 13 个工具，覆盖实时行情、K线、盘口、资金流、估值指标、交易日历等，是目前 AI 编程助手接入金融数据最便捷的方式之一。一个连接，覆盖 4 大市场、40,000+ 品种，且采用“统一 REST + WebSocket 接口、统一字段、统一鉴权”的设计，让你的 AI 编程体验顺畅无阻。

📡 本文所有行情数据服务由 TickDB.ai 提供，GitHub 开源，文档可查，代码可跑。

通过 TickDB API 获取实时行情数据

一个 API 接入外汇、加密货币、美股、港股、A股、贵金属和全球指数的实时行情。支持 WebSocket 低延迟推送，免费开始使用。

免费领取 API Key查看 API 文档

相关文章