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 通過站內即時消息聯繫在線客服。

部署

uv build + upx（唯一推薦方式）

使用 uv 構建，並用 upx 壓縮，生成輕量、可分發的 MCP stdio 可執行文件。

# 安裝 uv（若未安裝）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安裝 upx（若未安裝）
# macOS: brew install upx
# Linux: sudo apt install upx

# 构建 + 壓縮
uv build

構建产物位於 dist/ 目錄，可直接用于 MCP stdio 模式（Cursor / Claude Desktop / OpenCode）：

快速配置

支持配置的平台：

• ✨ Cursor
• ✨ Claude Desktop
• ✨ OpenCode

手動配置環境變量

export TOKEN="your_token"
# export ITICK_API_BASE="https://api.itick.io"

Run (stdio)

itick-mcp
# 或
# http方式啟動
python3 -m itick_mcp_server  --transport http
# sse方式啟動
python3 -m itick_mcp_server  --transport sse
# stdio方式啟動
python3 -m itick_mcp_server

Cursor / Claude Desktop

{
  "mcpServers": {
    "itick": {
      "command": "uvx",
      "args": [
        "itick-mcp"
      ],
      "env": {
        "TOKEN": "your_token"
      }
    }
  }
}

OpenCode

OpenCode 使用 opencode.json / opencode.jsonc 的 mcp 鍵，本地服務需將 type 設為 local，command 為字符串數組，環境變量放在 environment 中（與 Cursor 的 mcpServers / env 不同）。最小示例：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "itick": {
      "type": "local",
      "enabled": true,
      "command": ["uvx", "itick-mcp"],
      "environment": {
        "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。

代碼結構

• client.py — HTTP GET、ITICK_API_BASE / TOKEN
• tools_register.py — 註冊全部 REST 工具
• server.py — FastMCP 入口