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 映像使用。