Cursor / Claude Code 配置 MCP 金融行情数据源：3 步查询 A 股实时行情

摘要

Cursor 和 Claude Code 都能通过 remote HTTP MCP server 接入 TickDB 获取 A 股实时行情，但配置方式不同——一个编辑 JSON，一个执行命令。接入后应先确认工具可见，再查询 600519.SH 并核对 code、symbol、type、last_price 和 timestamp：这些字段构成数据可用性的验证基线。MCP 查询是单次工具调用，不是 WebSocket 持续推送。

1. 开篇：两个工具，一条验证链路

在 Cursor 或 Claude Code 中接入金融数据 MCP，核心问题不是“能不能连上”，而是“连上之后怎么验证数据真的可用”。本文用三步完成这条链路：配置 TickDB MCP Server → 确认工具可见 → 查询 600519.SH 并核对结构化字段。

先给结论：配置方式不同，验证标准相同。无论你用哪个 AI 编码工具，接入后都应看到 get_ticker 工具，并能用它查到 600519.SH——确认 code=0、data 非空、返回 symbol 与请求一致、type 为 stock、last_price 为非空可解析的有限字符串数值、timestamp 为有效整数——才算完成最小可用验证。

TickDB 在本文中的作用：作为 remote HTTP MCP server 的可运行实例。它的 get_ticker 工具返回结构化字段，让 AI Agent 在对话中直接获取实时行情。客户端侧的配置与验证思路可以迁移，但不同 MCP Server 的 transport、端点、鉴权 Header 和返回结构必须分别核验。TickDB 具体端点、Header 名和返回结构以官方文档为准：https://docs.tickdb.ai。

2. 两种工具的配置方式速查

配置维度	Cursor	Claude Code
配置入口	.cursor/mcp.json（项目级）	claude mcp add 命令（命令行添加，默认当前项目 local scope）
配置格式	JSON 静态文件	命令行参数
生效方式	编辑器启动时自动加载	命令执行后即时生效
适用场景	项目固定配置，团队共享	个人快速接入，临时测试

3. 三步之一：配置 TickDB MCP Server

Cursor 配置

在项目根目录创建 .cursor/mcp.json：

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

配置要点：type 必须为 "http"；X-TickDB-Key 用于身份鉴权，建议通过环境变量注入（${env:TICKDB_KEY}）。项目配置可以共享，但真实 Key 绝不能写入或提交 mcp.json。重启 Cursor 后配置自动生效。

Claude Code 配置

终端执行：

claude mcp add --transport http tickdb https://mcp.tickdb.ai/ \
  --header "X-TickDB-Key: YOUR_API_KEY"

配置要点：--transport http 指定 remote HTTP 传输；tickdb 是本地注册的 server 名称。执行成功后，配置写入当前项目的 Claude Code MCP 注册表，无需重启即可使用。如需全局可用，命令需增加 --scope user。

YOUR_API_KEY 替换为实际 Key，不要提交到版本控制。

4. 三步之二：确认客户端已连接并能看到工具

配置完成后，先确认 MCP Server 已正确加载。跳过这一步直接查行情，工具调用失败时不易定位是配置问题还是查询问题。

Claude Code：在对话中输入 /mcp 检查连接状态和工具列表，确认 tickdb 的 get_ticker 可见且连接正常。

Cursor：在 MCP 设置或 Available Tools 面板中检查 server 状态，确认 get_ticker 出现在工具列表中。

在对话中要求“列出 tickdb 提供的所有工具”可作为辅助确认动作。

常见配置故障速查：

现象	排查方向
无任何工具返回	Cursor：检查 .cursor/mcp.json 路径、type 是否设为 "http"、url 是否以 https:// 开头。Claude Code：执行 /mcp 检查 tickdb 注册状态
工具列表出现但 get_ticker 缺失	确认 MCP Server 版本与文档一致
连接超时或拒绝	检查网络可达性、防火墙规则、Key 是否有效

看到 get_ticker 出现在工具列表中，只说明 MCP 传输层可交互，工具描述被客户端成功读取——它不承诺特定 symbol 一定返回数据。那属于数据层验证，在第三步完成。

5. 三步之三：查询 600519.SH 并核对结构化字段

工具可见性确认后，在 AI 对话中输入：

"用 get_ticker 查一下 600519.SH"

AI Agent 会自动调用 get_ticker 工具，传入 symbols="600519.SH", type="stock"，返回结构化结果。

查询成功后，同时核对以下字段——这是数据可用性的验证基线：

验证项	核对要点
code	必须为 0
data	必须非空
symbol	返回 symbol 与请求的 600519.SH 完全一致，无缺失、无多余、无重复
type	必须为 stock
last_price	必须为非空字符串；可解析为有限数值（非 NaN/Infinity）。缺失不能默认成 0
timestamp	必须为有效整数，按当前工具语义判断，不跨接口假设统一

常见查询故障速查：

现象	可能原因	处理方向
返回 code: 1001	API Key 无效或已过期	检查 Key
返回 code: 3001	请求频率超限	按当前响应提供的信息执行有上限的退避，不无限重试
data 为空	原因待确认	检查 symbol、type、Key、工具返回和当前文档，不自行断言空数组原因
last_price 为 null 或空字符串	该品种暂未提供最新价	不默认成 0，记录异常
工具调用失败或超时	MCP Server 不可达	检查网络、端点 URL、Key 有效性

以上错误码以 TickDB 当前接口文档为准，不同 MCP Server 的错误码体系可能不同。

6. 延伸：什么时候用 MCP，什么时候不用

适合用 MCP 的场景：AI Agent 对话式查询、按需获取当前快照、在推理链路中嵌入行情数据。如果你只是偶尔让 AI 查一下当前价格，MCP 的单次调用模式正好匹配。

不适合用 MCP 的场景：盘中持续推送行情（应选 WebSocket）、批量回测数据拉取（应选 REST 脚本）、对延迟有严格要求的场景。MCP 是工具调用协议，不是流式推送协议——不要因为它能返回一次数据，就把它当成实时行情流来用。

📡 本文 MCP Server 示例由 TickDB.ai 提供，端点见 https://mcp.tickdb.ai/，接入文档见 https://docs.tickdb.ai ⚠️ 本文为技术教程，不构成任何投资建议