FxSocket

官方

唯讀存取代管的 MetaTrader 4 與 MT5 帳戶:餘額與淨值、未平倉部位與掛單、交易歷史、品種搜尋、即時報價與 K 線。

你可以用 FxSocket MCP 做什麼?

  • 帳戶總覽 — 列出金鑰可查看的每個帳戶,包含平台、伺服器、連線狀態,以及各幣別的餘額或淨值總計。
  • 未平倉曝險 — 顯示各帳戶的未平倉部位與掛單,可依商品代碼或類型篩選,並附上浮動盈虧、隔夜利息與總計。
  • 交易歷史回顧 — 彙總最多 366 天期間內的已平倉交易,包括勝率、淨利潤、最佳與最差交易,以及各商品代碼的明細。
  • 商品代碼查詢 — 在請求報價前先找出經紀商確切的商品代碼名稱,因為像 EURUSD 這類名稱會因經紀商而異。
  • 即時報價與規格 — 取得最多 20 個商品代碼的買價、賣價與點差,以及最小跳動值、交易量限制、隔夜利息率與交易時段等合約細節。
  • 價格歷史 — 提取某個商品代碼與時間週期的 OHLC K 線,每次呼叫最多 500 根 K 線,用以描述趨勢。

託管 MCP 伺服器

npx add-mcp 'https://mcp.fxsocket.com/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

MetaTrader MCP 伺服器

讓 AI 代理以唯讀方式存取你的 MetaTrader 4 與 MetaTrader 5 帳戶。FxSocket MCP 伺服器讓 Claude、Cursor、VS Code 以及任何其他 Model Context Protocol 用戶端,能夠回答關於你交易的問題:各帳戶的餘額與淨值、目前有哪些持倉、上個月的表現、即時報價與價格歷史。它是唯讀的。 沒有任何工具可以下單、修改或平倉。

伺服器 URL https://mcp.fxsocket.com/mcp

1. 建立唯讀 API 金鑰

在 API Key 頁面 建立一把唯讀金鑰。它的開頭是 fxs_ro_,可以呼叫這裡的每一個工具,也無法透過任何其他端點進行交易。為它命名,並限制它只能存取代理應該看到的帳戶,這樣代理就永遠不會知道其他帳戶的存在。你的完整 fxs_live_ 金鑰也能使用,但代理並不需要這種金鑰。

2. 連接你的用戶端

接受遠端伺服器 URL 與標頭的用戶端可直接連線。只能啟動本機伺服器的用戶端(例如 Claude Desktop)則使用 Docker 映像。

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"
{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}
{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}
{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

任何其他用戶端的運作方式都相同:將它指向 https://mcp.fxsocket.com/mcp,並在 X-API-Key 標頭中放入金鑰(也接受 Authorization: Bearer),或將 Docker 映像作為本機伺服器執行。

工具

八個工具,全部唯讀。每個工具都圍繞一個問題而非一個端點設計,因此「我的各帳戶目前有哪些持倉」只需一次呼叫,就能同時讀取每個終端機。

  • list_accounts:金鑰可見的每個帳戶,包含其 id、暱稱、平台、伺服器、登入名稱與連線狀態,可選擇附上餘額、淨值與各幣別合計。代理會先呼叫它。
  • get_account:單一帳戶的完整資訊:餘額、淨值、保證金、保證金水平與槓桿、帳戶設定(例如強制平倉水平),以及終端機健康狀態。
  • get_open_positions:跨帳戶的未平倉持倉與掛單,可依品種與類型篩選,附浮動盈虧、隔夜利息與各幣別合計。
  • get_trade_history:特定期間內的已平倉交易(預設為最近 7 天,最多 366 天),包含獲利次數、虧損次數、勝率、淨利潤、最佳與最差交易,以及依品種的分項統計。
  • search_symbols:經紀商使用的確切品種名稱。在某些經紀商,EURUSD 是 EURUSD.sd 或 EURUSDm,因此代理在查詢價格前會先查詢它。
  • get_quotes:最多 20 個品種的即時買價、賣價與點差。
  • get_symbol_info:合約規格:小數位數、合約大小、每跳動點價值、交易量限制、隔夜利息率、手續費與交易時段。
  • get_price_history:指定品種與時間週期的 OHLC K 線,每次呼叫最多 500 根。

你可以問什麼

  • 「我所有帳戶的總淨值是多少,依幣別分別列出?」
  • 「目前哪些未平倉持倉處於虧損,虧損多少?」
  • 「我上個月在 XAUUSD 的勝率是多少,最差的一筆交易是什麼?」
  • 「比較我各經紀商的 EURUSD 點差。」
  • 「取得 GBPUSD 最近 200 根 H1 K 線,並描述趨勢。」

設計上即為唯讀

伺服器無法交易,原因在於其程式碼能觸及的範圍,而非某項設定:每個工具都只從終端機讀取,沒有任何一個能送出訂單。因此,即使代理混淆或遭到操縱,仍然無法開倉、修改或平倉。

金額以各帳戶的入金幣別回報,且絕不會跨幣別相加;工具會回傳各幣別的合計,讓模型不必自行做這項算術。時間為經紀商伺服器時間,與 API 其他部分一致。

限制:每位使用者每分鐘 60 次請求,單次回覆最多 50 個帳戶與 300 筆訂單或交易列。計數與合計一律涵蓋全部資料;只有列出的明細會被截斷。

使用 Docker 在本機執行

fxsocket/mcp 映像會將伺服器作為本機 stdio 程序執行,適用於自行啟動伺服器的用戶端。它是一個小型中繼程式,單一 Python 檔案、無相依套件,會將每則訊息連同你的金鑰轉送至 mcp.fxsocket.com。工具與你的資料仍來自 FxSocket,因此工具變更時映像永遠不需要更新。已為 amd64 與 arm64 發布。

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · GitHub 上的原始碼(MIT)

協定細節

  • 傳輸: Streamable HTTP,僅限 POST,JSON 回應。無狀態,沒有需要維持的 session。
  • 協定版本: 2026-07-28(每請求中繼資料,無握手)以及 2025-03-26 至 2025-11-25(initialize 握手)。
  • 驗證: 與 平台 API 相同的 API 金鑰,放在 X-API-Key 或 Authorization: Bearer 中。
  • 尚未支援: claude.ai 與 ChatGPT 中的網頁連接器,它們以 OAuth 而非標頭登入。Claude Desktop 目前可透過 Docker 映像使用。