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

• 环境准备
• 配置 MCP 连接
• MCP 工具速查表
• 验证连接 & 查询示例
• 常见问题
• 延伸：Cursor 量化工作流实战

在 Cursor 里写量化策略时，反复切换窗口查行情数据？只要一次 MCP 配置，你的 AI 编程助手就能直接调用真实的金融数据——本篇带你从零到一完成全部步骤，所有代码和命令均可直接复制运行。

环境准备

开始前，请确认以下条件：

• Cursor IDE 已安装（官网下载）。
• 无需额外安装任何 SDK：TickDB 的 MCP 服务为云端托管，Cursor 原生支持 MCP 协议，直接配置即可。
• 一个 TickDB API Key：免费获取，无需绑定信用卡，流程见下。

获取 TickDB API Key

1. 打开 tickdb.ai，点击“免费开始”注册账号。
2. 登录后在控制面板生成一个 API Key。
3. 复制 Key，后续配置中以 YOUR_API_KEY 代替（形如 ZolsmxPs...qPy）。

费用说明：有免费体验额度，注册即可开始，无需信用卡。免费额度覆盖所有基础行情查询，足够验证本教程全部功能。

配置 MCP 连接

Cursor 支持通过 JSON 文件配置 MCP 服务器，配置立即可用，无需重启系统服务。按以下步骤操作：

1. 打开 MCP 配置文件

在 Cursor 中，可以创建项目级配置（仅当前项目可用，推荐），或全局配置（所有项目生效）。

• 项目级：在项目根目录新建 .cursor/mcp.json。
• 全局：在用户目录下创建 ~/.cursor/mcp.json（Linux/macOS）或 %USERPROFILE%\.cursor\mcp.json（Windows）。

2. 填入完整 JSON 配置

将以下内容完整复制到配置文件中，不需要做任何删改（只需把 YOUR_API_KEY 替换为你的真实 Key）：

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

配置要点（务必核对）：

• mcpServers：服务列表，键名 tickdb 可自定义，会在 Cursor 内作为服务器标识。
• url：TickDB 官方托管的 MCP 端点，无需自部署任何服务。
• headers.Authorization：鉴权字段，格式为 Bearer + 空格 + API Key。注意：此处与 TickDB REST API 的 X-API-Key Header 不同，不可混淆。MCP 服务统一使用 Authorization: Bearer 方式。

为什么鉴权方式不同？ REST API 用 X-API-Key 是面向开发者的简洁方案；MCP 用 Authorization: Bearer 是遵循 MCP 协议的标准鉴权规范，确保与 Claude、Cursor、Windsurf 等所有 MCP 兼容客户端的互操作性。两者指向同一套后端服务，效果等效。

3. 保存并重启 Cursor

保存配置文件后，完全退出 Cursor 并重新打开，让 MCP 服务加载配置。重新进入你的项目后，AI 助手便会自动识别 tickdb 工具集。

MCP 工具速查表

TickDB MCP 服务共提供 13 个工具。以下列出常用工具及其对应的 REST 端点，帮助你写出更精准的自然语言指令：

品种代码格式提示：A股为 6 位数字 + .SH/.SZ/.BJ（如 600519.SH）；港股为数字 + .HK（如 700.HK，无前导零）；美股为字母 + .US（如 AAPL.US）；加密货币直接写币对（如 BTCUSDT）。

验证连接 & 查询示例

可选：用 Python 快速验证 API Key 有效性

如果不确定 Key 是否正确，可在终端运行以下 Python 脚本。它直接调用 TickDB REST API，如果返回 code:0，说明 Key 有效，可放心进行 MCP 配置。

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 则 Key 有效

在 Cursor 中验证 MCP 连接

打开 Cursor 的 AI 对话框（快捷键 Ctrl+L 或 Cmd+L），输入以下自然语言指令，观察 AI 是否能返回包含真实数值的行情数据。

示例 1：查询实时价格

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

如果配置正确，Cursor 会自动调用 TickDB 提供的 MCP 工具 get_ticker，返回类似如下结果：

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

MCP 实际返回结构（关键字段）：

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "BTCUSDT",
      "last_price": "87234.50",
      "price_change_percent_24h": "-1.2",
      "volume_24h": "45632178950",
      "high_24h": "89100.00",
      "low_24h": "86800.00",
      "timestamp": 1747622400000
    }
  ]
}

以上为真实返回结构。价格字段名为 last_price，时间字段名为 timestamp（毫秒 UTC），数据包裹在 data 数组中。开发时可直接据此结构取值。

示例 2：获取历史K线并计算均线

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

AI 会通过 MCP 拉取 TickDB 的 K 线数据，在对话中直接计算并输出结果。全程无需你编写 HTTP 请求或数据解析代码。

示例 3：股票估值对比

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

AI 会自动调用市场指标接口 get_calc_index，生成结构化的对比表格。这些接口覆盖美股、港股、A 股的完整基本面数据。

成功标志：Cursor AI 对话返回包含真实数值的行情数据，且引用的价格与 tickdb.ai 控制台实时显示一致。如果返回“无法找到 MCP 服务器”或无法查询，请检查下一节的常见问题。

常见问题

Q1：配置后提示“无法找到 MCP 服务器 tickdb”怎么办？

请逐一排查以下项：

• JSON 语法是否正确（不允许尾随逗号，所有引号必须为半角双引号）。
• 文件路径是否正确：项目级配置必须放在项目根目录的 .cursor/mcp.json，全局配置放在 ~/.cursor/mcp.json。
• Authorization 值格式：必须是 Bearer （注意 Bearer 后有一个空格）加上你的 API Key。
• 确认完全重启了 Cursor（关闭所有窗口再重新打开）。

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

免费额度有调用频率和每日配额限制。遇到此错误时，MCP 返回结构中会包含 code 字段和限流提示，AI 会根据错误码提示你升级。典型返回结构如下：

{
  "code": 3001,
  "message": "Rate limit exceeded",
  "data": {
    "limit": 60,
    "plan": "starter",
    "reset_at": 1747623598
  }
}

当 AI 回复中出现此类内容时，说明配额已满。可等待 reset_at 标记的时间戳（毫秒 UTC）后重试，或访问 tickdb.ai 升级订阅方案获取更高配额。实现自动处理时，可在代码中捕获 code == 3001，读取返回的 reset_at 时间，做指数退避重试。

Q3：为什么在 Cursor 里直接说话就能查行情？

这正是 MCP（Model Context Protocol）的核心价值——它将 API 工具化并交付给 AI。你只需要告诉 AI “做什么”，AI 会自动选择对应的工具（如 get_ticker、get_kline）并处理请求参数，对开发者屏蔽了 HTTP 和鉴权细节。这就好比一位熟练的助手，你只需下达指令，它帮你操作数据终端。

延伸：Cursor 量化工作流实战

有了 MCP 实时行情支持，你的 Cursor 可以升级为一站式量化开发工作站。尝试以下几个场景，感受效率变化：

1. 实时策略调试

在 AI 对话框中直接说：

写一个双均线交叉策略，用 BTCUSDT 的 5 分钟和 15 分钟实时 K 线进行模拟。当金叉出现时打印信号，并画出价格和均线图。

AI 会直接基于 TickDB 推送的真实数据生成完整 Python 代码，包含数据获取、指标计算、信号输出和可视化——无需你手动请求任何数据接口。

2. 全市场条件筛选

输入以下自然语言指令：

找出港股中市盈率低于 10、股息率大于 3% 且总市值超过 1000 亿港币的股票，按股息率从高到低排序。

Cursor 会调用 TickDB 的股票信息与估值接口，几分钟内完成筛选并输出列表，比人工在财经网站逐页翻找高效得多。

3. 每日盘后报告自动生成

你可以设定一个 Cursor 任务，每日定时执行：

拉取我的自选组合（AAPL.US, 700.HK, 600519.SH）的当日分时数据、资金流向和估值变化，生成一份 Markdown 格式的复盘日报。

AI 会自动调用多个接口，整合成分门别类的报告，节省大量手动复盘时间。

TickDB 的 MCP 端点 https://mcp.tickdb.ai 提供了 13 个工具，覆盖实时行情、K线、订单簿、资金流向、估值指标、交易日历等，是目前 AI 编程助手接入金融数据高效的接入方式之一。它践行 “对话用 Skill，编码用 MCP” 的理念，通过 统一 REST + WebSocket 接口、统一字段、统一鉴权，让一个连接覆盖 4 大市场、40,000+ 品种。

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

如果这篇教程帮你省下了折腾 MCP 配置的时间，欢迎点赞收藏，让更多量化开发者看到。

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

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