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 端点，帮助你写出更精准的自然语言指令：

工具名	对应 REST 端点	用途	典型问法
get_ticker	GET /v1/market/ticker	获取实时行情快照	“BTCUSDT 最新价多少”
get_kline	GET /v1/market/kline	获取历史K线数据	“拉取 700.HK 最近 10 根日K线”
get_kline_latest	GET /v1/market/kline/latest	获取当前实时K线	“AAPL.US 当前 5 分钟K线”
get_depth	GET /v1/market/depth	获取订单簿深度	“BTCUSDT 买卖盘口”
get_trades	GET /v1/market/trades	获取最近成交记录	“700.HK 最近成交”
get_stock_info	GET /v1/market/stock-info	获取股票基本面	“700.HK 每手股数、总股本”
get_calc_index	GET /v1/market/calc-index	获取估值指标	“MSFT.US 市盈率、市净率”
get_capital_flow	GET /v1/market/capital-flow	获取资金流向	“700.HK 主力资金动向”
get_intraday	GET /v1/market/intraday	获取当日分时数据	“600519.SH 今日分时走势”
get_trading_sessions	GET /v1/market/trading-sessions	查询交易时段	“港股今天几点开盘”
get_trade_days	GET /v1/market/trade-days	查询交易日历	“A股本月有哪些交易日”
get_symbols	GET /v1/symbols/available	查询支持的品种列表	“港股有哪些标的可查”
get_kline_intervals	GET /v1/market/intervals/kline	查询支持的K线周期	“支持哪些K线周期”

品种代码格式提示：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 配置的时间，欢迎点赞收藏，让更多量化开发者看到。