远程 MCP 已配置，为什么你的 AI 开发工具仍查不到 A 股行情？

摘要

在 Cursor 或 Claude Code 里接入了 TickDB 的远程 MCP 金融行情数据源，transport 显示已连接，工具列表里也能看到 get_ticker------但一查 A 股，返回的却是空数据或意料之外的错误码。问题出在哪？本文把"配置完成"到"数据真正可用"拆成三个工程闸门：transport 连通、tool 可发现、result 通过 contract check。文中以 TickDB 的 remote HTTP MCP 为可复核示例，给出最小配置片段、故障定位流程和一份结果校验伪代码，帮你把"连上了"升级为"验过了"。

AI 开发工具接入 MCP 金融行情数据源时，最让人困惑的时刻往往不是连不上，而是明明连上了，模型却说"我没有拿到有效数据"。

大语言模型不是实时行情数据库。Cursor 和 Claude Code 可以通过 MCP 协议接入外部金融行情工具，让模型在需要时主动查询 A 股等资产的快照。但"配置完成"不等于"数据可用"------要真正让 AI 拿到可用的行情，你需要依次通过三道闸门。

TickDB 在本文中作为 remote HTTP MCP 金融行情数据源的可运行实例。客户端侧的配置与验证思路可以迁移，但不同 MCP Server 的端点、鉴权 Header、工具参数和返回结构必须分别核验。

三道闸门：从配置到可用的完整路径

一条最小验证链路包含三个独立判断：

Transport 闸门：MCP Server 已配置，且客户端能够建立连接。
Tool 闸门 ：客户端能够发现并列出目标工具（如 get_ticker）。
Result 闸门 ：查询真实 A 股 symbol 后，返回结果通过 contract check------code=0、data 非空、字段类型正确、symbol 与请求一致。

下面以 Cursor 和 Claude Code 接入 TickDB MCP 为例，逐步走完这三步。

闸门一：Transport 连通与配置

两个客户端的配置入口不同，但核心原则一致：真实 Key 必须通过环境变量注入，绝不能硬编码在配置文件或命令行中。

Cursor 配置

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

json 复制代码

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

TICKDB_KEY 需要先存在于运行 Cursor 的系统环境中。保存配置后，到 Cursor 的 MCP 设置或 Available Tools 中检查 server 加载状态；如果未加载，查看 MCP Logs 或重载窗口。

Claude Code 配置

先在当前终端会话中设置环境变量：

bash 复制代码

export TICKDB_KEY="YOUR_API_KEY"

再添加 remote HTTP MCP server：

bash 复制代码

claude mcp add --transport http tickdb https://mcp.tickdb.ai/ \
  --header "X-TickDB-Key: ${TICKDB_KEY}"

这条命令默认使用 local scope：只在当前项目中对当前用户可用。如需跨项目使用，可增加 --scope user。

Transport 闸门的判定标准： 客户端日志或状态面板显示 server 已连接，无超时或拒绝连接错误。

闸门二：Tool 可见与可用性确认

连接建立后，先确认 MCP Server 已正确加载并暴露了预期的工具。跳过这一步直接查行情，调用失败时很难区分是配置问题、连接问题还是数据问题。

Claude Code ：在交互会话中执行 /mcp，检查 tickdb 的连接状态和工具列表。
Cursor ：在 MCP 设置或 Available Tools 中检查 server 状态，确认 get_ticker 可见。

看到 get_ticker 只说明客户端已经读取到工具描述，不承诺某个 A 股 symbol 一定能返回有效数据。

现象	排查方向
没有看到 TickDB server	检查配置位置、JSON 格式、端点和客户端日志
server 可见但没有 `get_ticker`	核对当前 server 配置和官方工具清单
连接超时或拒绝	检查网络可达性、防火墙、端点和 Key
Claude Code 显示未连接	使用 `/mcp` 查看具体状态，不把 Cursor 的排查路径直接套过来

Tool 闸门的判定标准： 在客户端工具列表中能看到 get_ticker，且其参数描述与文档一致。

闸门三：Result 契约核对

前两道闸门通过后，查询一只真实 A 股，并对返回结果做 contract check。

在对话中输入：

用 get_ticker 查询 600519.SH，type 使用 stock。不要只复述价格，请同时返回 code、data、symbol、type、last_price 和 timestamp，供我核对。

对应的 MCP 工具参数是：

text 复制代码

get_ticker(symbols="600519.SH", type="stock")

2026 年 6 月 15 日的本轮实测返回 code=0，data 非空，且可见 symbol、type、last_price 和 timestamp 等字段。动态价格不在本文公开。

一次查询至少检查以下项目：

验证项	核对标准
`code`	必须为 `0`，但不能只检查这一项
`data`	必须是非空数组
`symbol`	与请求的 `600519.SH` 完全一致，无缺失、多余或重复
`type`	与本次请求一致，为 `stock`
`last_price`	非空字符串，可解析为有限十进制数；缺失时不得默认成 `0`
`timestamp`	必须是有效整数，且不能让 Python 的 `bool` 混入

如果要把这套检查写进自动化流程，可以采用失败关闭的教学示例：

python 复制代码

from decimal import Decimal, InvalidOperation

def validate_ticker(response: dict, expected_symbol: str) -> dict:
    if response.get("code") != 0:
        raise ValueError(f"business error: {response.get('code')}")

    data = response.get("data")
    if not isinstance(data, list) or len(data) != 1:
        raise ValueError("data must contain exactly one ticker item")

    item = data[0]
    if item.get("symbol") != expected_symbol:
        raise ValueError("returned symbol does not match request")
    if item.get("type") != "stock":
        raise ValueError("unexpected asset type")

    raw_price = item.get("last_price")
    if not isinstance(raw_price, str) or not raw_price:
        raise ValueError("last_price must be a non-empty string")
    try:
        price = Decimal(raw_price)
    except InvalidOperation as exc:
        raise ValueError("last_price is not a decimal string") from exc
    if not price.is_finite():
        raise ValueError("last_price must be finite")

    timestamp = item.get("timestamp")
    if isinstance(timestamp, bool) or not isinstance(timestamp, int) or timestamp <= 0:
        raise ValueError("timestamp must be a positive integer")

    return item

这段代码的核心逻辑是：发现异常就阻断，不把缺失价格默认为 0，不在 warning 后继续向下游提交。它是教学示例，不是生产级程序。

Result 闸门的判定标准： 返回结果通过上述所有检查项，不出现意外缺失、类型错配或字段为空。

常见故障怎么定位

现象	处理方向
返回 `code: 1001`	Key 无效或过期，应检查或更换 Key，不应盲目重试
返回 `code: 3001`	触发频率限制，按当前响应信息执行有上限的退避
`data` 为空	检查 symbol、type、Key 与当前工具文档，不自行假定原因
`last_price` 缺失或为空	阻断本次结果，不默认成 `0`
工具调用失败或超时	检查客户端状态、网络、端点和 Key

错误码属于 TickDB 当前接口语义，不能套用到其他 MCP Server。

什么时候用 MCP，什么时候不用

适合 MCP 金融行情数据源的场景：AI Agent 对话式查询、按需获取 A 股等资产的当前快照、在推理链路中调用行情工具。

不适合 MCP 的场景：需要持续行情推送时应评估 WebSocket；批量历史数据任务应使用适合脚本化调用的接口；对延迟有严格要求的系统需要单独验证链路、配额和稳定性。

MCP 是 AI 工具调用入口，不是 WebSocket 行情订阅通道。一次 get_ticker 成功，也不能证明 REST、WebSocket、全部 A 股、延迟或 SLA。

不能从本文推出什么

本轮实测只证明 2026 年 6 月 15 日通过 TickDB MCP get_ticker 查询 600519.SH 时，返回了可核对的结构化 ticker 快照。
本文没有公开动态价格，也不对价格、延迟、SLA、套餐或覆盖总量作出承诺。
Cursor 与 Claude Code 的配置不能互相复制；其他 MCP Server 的端点、Header、工具参数和返回结构需独立核验。
本文只讨论行情工具接入和工程校验，不构成投资建议。

开发者检查清单

Transport：客户端已连接 TickDB MCP Server，无超时或拒绝错误。
Tool：get_ticker 在工具列表中可见，参数与文档一致。
Key：真实 Key 通过环境变量注入，未硬编码或截图。
查询：使用 symbols="600519.SH" 和 type="stock" 发起调用。
code：返回 0。
data：非空数组，symbol 与请求一致，无缺失或重复。
last_price：可解析为有限 Decimal 的非空字符串，缺失时阻断，不默认为 0。
timestamp：正整数，排除了 bool。
异常：任何检查失败都会阻断流程，不静默继续。

连上 MCP 金融行情数据源、看到工具列表、查到一条 A 股返回------这三件事分别对应三道独立的闸门。只有三道闸门全部通过，你才能说"我的 AI 开发工具确实可以拿到可用的行情数据"。

TickDB 的 remote HTTP MCP server 提供了可复核的验证路径。官方配置与工具说明见其 GitHub 仓库。

标签： MCP, AI Agent, 金融行情数据源, 行情数据, Cursor, TickDB