MCP Server REST API 和 WebSocket 实时推送接口 金融数据API文档 SDK & 开发工具 iTick 官方MCP Server，提供基础、股票、指数、期货、基金、外汇、加密货币数据的 REST API 查询和 WebSocket 实时数据订阅功能。

MCP Server 介绍

iTick 官方 MCP Server 是 iTick 金融数据平台官方推出的标准化协议服务器，基于 Model Context Protocol (MCP) 构建，为 AI 助手（如 Claude Desktop、Cursor 等）提供统一的金融数据访问入口。该服务器封装了 iTick 在全球外汇、股票、指数、期货、基金及加密货币等领域的高质量数据能力，支持 REST API 批量查询与 WebSocket 实时推送，开发者仅需配置 API Key 即可在 AI 对话环境中即时调用专业金融数据，大幅降低数据集成门槛

特点

• 开发者友好：标准易用接口、简明文档与丰富示例，便于快速接入。
• 产品线丰富：多市场股票、外汇、指数、加密货币等实时与历史数据。
• 多场景适用：量化团队、金融科技与专业分析等场景。
• 服务与基础设施：专业数据源、多地区加速与链路热备份，侧重实时与稳定。
• 定制化：机构与专业用户可洽谈定制数据方案。

iTick API 类型与本项目范围

FIX 仅机构开放时，可联系官方客服：Telegram @iticksupport、WhatsApp +852 59046663。

技术支持（摘要）

• 邮件：support@itick.org（建议主题中注明环境、身份与问题描述）
• 营业时间：周一至周五 9:00–18:00（香港时间）；紧急生产问题以官方说明为准。
• 非办公时间：可登录 itick.org 通过站内即时消息联系在线客服。

部署

cd itick-mcp-server
pip install -e .
# 若只有 python3：pip3 install -e .

环境变量：

export ITICK_TOKEN="your_token"
# export ITICK_API_BASE="https://api.itick.org"

Run (stdio)

itick-mcp
# 或
python3 -m itick_mcp_server

Cursor / Claude Desktop

{
  "mcpServers": {
    "itick": {
      "command": "itick-mcp",
      "env": {
        "ITICK_TOKEN": "your_token"
      }
    }
  }
}

未装到 PATH 时（安装 editable 后一般可省略 PYTHONPATH）：

{
  "mcpServers": {
    "itick": {
      "command": "python3",
      "args": ["-m", "itick_mcp_server"],
      "cwd": "/absolute/path/to/itick-mcp-server",
      "env": {
        "ITICK_TOKEN": "your_token"
      }
    }
  }
}

OpenCode

完整步骤（虚拟环境、配置文件路径、opencode mcp CLI、超时与排错）见 docs/opencode.md。

OpenCode 使用 opencode.json / opencode.jsonc 的 mcp 键，本地服务需将 type 设为 "local"，command 为字符串数组，环境变量放在 environment 中（与 Cursor 的 mcpServers / env 不同）。最小示例：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "itick": {
      "type": "local",
      "command": ["itick-mcp"],
      "enabled": true,
      "environment": {
        "ITICK_TOKEN": "your_token"
      }
    }
  }
}

MCP 工具一览

与 REST 文档 路径对应：

基础

• symbolList → GET /symbol/list
• symbolHolidays → GET /symbol/v2/holidays

股票（额外）

• stockInfo → GET /stock/info
• stockIpo → GET /stock/ipo
• stockSplit → GET /stock/split

各产品线（stock / crypto / forex / indices / future / fund）

批量接口中 codes 为英文逗号分隔。K 线参数在工具中为 k_type，请求中会编码为 kType；可选 et（毫秒时间戳）、limit。

与早期 Java 示例一致的股票单笔 K 线工具名仍为 stockKline。

代码结构

• itick_mcp_server/client.py — HTTP GET、ITICK_API_BASE / ITICK_TOKEN
• itick_mcp_server/tools_register.py — 注册全部 REST 工具
• itick_mcp_server/server.py — FastMCP 入口