Twelve Data

官方

與 Twelve Data API 互動，為您的 AI 代理獲取即時與歷史金融市場數據。

GitHub
86

你可以用 Twelve Data MCP 做什麼？

  • 即時與歷史價格 — 查詢股票、ETF、外匯、加密貨幣或大宗商品（如 AAPL 或 BTC/USD）的當前或歷史報價。
  • 技術指標 — 請求 RSI、MACD、SMA、BBANDS、ATR 或其他 60 多種指標，適用於任何受支援的標的。
  • 基本面與公司行動 — 取得盈餘、股利、拆股、財務報表、公司簡介、市值或關鍵統計數據。
  • 市場新聞與情報 — 擷取公司新聞、新聞稿、市場動向、分析師評級、目標價或匯率。
  • 基金與監管數據 — 存取 ETF/共同基金簡介、持股、SEC/EDGAR 申報文件、內部人交易或機構持股。

文件

Twelve Data MCP 伺服器

將 Claude、ChatGPT 及其他 AI 助手連接到 Twelve Data 金融 API — 即時與歷史價格、60 多種技術指標、基本面、財報、股息、ETF、公司新聞、市場異動等。

您需要一個 Twelve Data 帳戶。請在 twelvedata.com 註冊。

有兩種使用方式。大多數人應使用雲端伺服器（選項 1） — 無需安裝任何東西。

選項 1 — 使用我們的雲端伺服器（建議）

將您的 AI 助手連接到我們的託管伺服器：

https://mcp.twelvedata.com/mcp

就是這樣。無需安裝，無需複製貼上 API 金鑰。連接時，瀏覽器視窗會開啟，您使用 Twelve Data 帳戶登入 — 您的個人 API 金鑰會自動連結並與您的帳戶綁定。

如何新增

Claude（桌面版／網頁版）和 ChatGPT 支援自訂連接器／MCP 伺服器：

  1. 開啟您助手的 連接器（或 整合／MCP 伺服器）設定。
  2. 使用 URL https://mcp.twelvedata.com/mcp 新增一個新連接器。
  3. 出現提示時，點擊 連接／登入 — 瀏覽器中會開啟 Twelve Data 登入頁面。
  4. 授權後即完成。可以詢問像是 「AAPL 的 RSI 是多少？」 或 「顯示 TSLA 最新的財報。」

不同應用程式和版本的功能表名稱可能不同，但流程始終相同：新增 URL，然後透過瀏覽器彈出視窗登入。

MCP 主機不會發行權杖。連接器 URL 是 https://mcp.twelvedata.com/mcp。用戶端必須遵循該 URL 的受保護資源中繼資料，前往其中指定的授權伺服器。請勿將連接器指向主機根目錄（會回傳 404），也不要指向此主機的 /register 或 /.well-known/oauth-authorization-server。

Perplexity（自訂遠端連接器）

Perplexity Pro、Max 和 Enterprise 使用者可以將託管伺服器新增為自訂遠端連接器。這是每個帳戶的設定，不是 Perplexity 公開精選目錄中的項目。

  1. 在 Perplexity 中，開啟 帳戶設定 → 連接器 → + 自訂連接器，然後選擇 遠端。在 Enterprise 版中，管理員可能需要先允許自訂連接器。
  2. 將 名稱 設為 Twelve Data，MCP 伺服器 URL 設為 https://mcp.twelvedata.com/mcp。
  3. 選擇 OAuth 進行驗證，Streamable HTTP 作為傳輸方式。將 Client ID 和 Client Secret 留空，以便 Perplexity 可以在伺服器受保護資源中繼資料中指定的授權伺服器上使用動態用戶端註冊。
  4. 接受 Perplexity 的自訂連接器確認，然後點擊 新增。接著點擊 Twelve Data 連接器卡片開始驗證，登入您的 Twelve Data 帳戶並授權存取。
  5. 連接器啟用後，嘗試以下提示：
    • "使用 Twelve Data 查詢 AAPL 代號。"
    • "使用 Twelve Data 取得 AAPL 的最新報價，包括價格和成交量。"
    • "使用 Twelve Data 顯示 AAPL 最近五個交易日的收盤價。"
    • "使用 Twelve Data 顯示 AAPL RSI。"

每個人使用自己的 Twelve Data 帳戶登入。如果 Enterprise 管理員共用連接器，請要求每個成員進行個人驗證。請勿將 Twelve Data API 金鑰貼到連接器的 API 金鑰驗證欄位中。

如果 OAuth 視窗被封鎖、登入失敗，或工具在閒置後停止運作，請開啟 Twelve Data 連接器，停用後重新啟用並登入。請以這種方式重新連接，而不是將連接器切換為 API 金鑰驗證。確認 URL 精確為 https://mcp.twelvedata.com/mcp，沒有尾端斜線，且 Twelve Data 方案包含所請求的資料。請參閱 Perplexity 的自訂遠端連接器指南 了解目前的設定畫面。

Codex（CLI、桌面版和 IDE）

將託管 MCP 伺服器新增到 Codex，無需安裝此儲存庫或複製 API 金鑰：

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

add 命令會啟動 OAuth：在瀏覽器中完成 Twelve Data 登入。如果之後需要重新授權，請執行 codex mcp login twelvedata。在 Codex 中，使用 /mcp 檢查連線，然後詢問："使用 Twelve Data 取得 AAPL 的最新報價。" 和 "使用 Twelve Data 顯示 AAPL RSI。" 若要斷開連線，請執行 codex mcp remove twelvedata。

公開外掛程式儲存庫是 https://github.com/MazeBraker/twelvedata-skills. 它會安裝技能和相同的託管 MCP：

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

選項 2 — 使用 API 金鑰自行執行

偏好在自己的機器上執行伺服器？您只需要 Twelve Data API 金鑰 — 無需 OAuth 設定。請在 twelvedata.com → 您的儀表板 → API 金鑰 取得。

1. 安裝

需要 Python 3.10+（建議 3.12；在 macOS 上為 brew install python@3.12 或 make python-install）。

make install

2. 新增您的 API 金鑰

在專案根目錄建立一個 .env 檔案，內容為您的金鑰，且僅限您本人可讀：

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

伺服器會從 .env 讀取金鑰，每個請求都會使用它。無需登入步驟。

3. 透過 stdio 連接

Claude Desktop — 新增到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

使用 .venv/bin/python 路徑（不要使用系統 Python — macOS 內建 3.9，而此伺服器需要 3.10+）。編輯設定後請重新啟動 Claude Desktop。

Claude Code：

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. 透過 HTTP 連接

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. 在 Docker 中執行

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file 可讓金鑰不進入您的 shell 歷史記錄。如步驟 4 所述連接到 http://localhost:8000/mcp。Docker 不支援 OAuth 登入。

6. 安全性

  • make run 和 Docker 在 0.0.0.0 上提供 /mcp，無任何驗證。
  • 每次呼叫都在您的憑證下執行。
  • 任何能存取該連接埠的人都可以呼叫 auth_status 和 oauth_configure。這包括您開啟的網頁，透過 DNS 重新綁定攻擊，因為預設綁定不會檢查 Host 或 Origin 標頭。
  • MCP_HOST=127.0.0.1 make run 可讓伺服器保持在本機，並啟用 MCP SDK 的 Host 和 Origin 檢查。
  • 使用 MCP_HOST=127.0.0.1 時，ngrok 僅在搭配 --host-header=rewrite 啟動時才能運作。

7. 疑難排解

先從您的用戶端呼叫 auth_status。它會顯示是否已設定 API 金鑰、儲存的權杖、偵測到的主機和重新導向 URI — 通常足以看出缺少什麼。

您可以詢問的內容

  • 價格 — 股票、ETF、外匯、加密貨幣、大宗商品（即時與歷史）
  • 技術指標 — RSI、MACD、SMA、BBANDS、ATR 及 60 多種其他指標
  • 基本面 — 財務報表、財報、股息、拆股、公司簡介、市值、關鍵統計、IPO 行事曆
  • 基金 — ETF 與共同基金簡介、績效、持股、風險
  • 新聞 — 公司新聞與新聞稿
  • 市場情報 — 異動股、匯率、分析師評級、目標價
  • 監管 — SEC/EDGAR 申報、內部人交易、機構持股

代號格式：股票 AAPL、加密貨幣 BTC/USD、外匯 EUR/USD。

合作夥伴

想要執行自己的公開執行個體或設定專屬 OAuth 登入？這屬於合作夥伴安排 — 請透過 twelvedata.com 與我們聯繫，我們將提供設定指南和 OAuth 憑證。