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 入口