Capital.com Public API MCP Server

官方

Capital.com MCP Server 讓您的 AI 助手直接與交易帳戶對話。市場數據、持倉檢查、交易預覽——全部以自然語言完成，無需離開您的 AI 工具。

GitHub

試用此 MCP贊助

你可以用 Capital Com Public API MCP 做什麼？

檢查工作階段狀態 — 交易前，請要求您的助理透過 cap_session_status 驗證登入狀態與環境。
搜尋市場 — 使用 cap_market_search 尋找可交易的工具（例如「比特幣」），並取得其 EPIC 代碼。
預覽交易 — 使用 cap_trade_preview_position 要求進行風險檢查的交易預覽，以在執行前驗證規模與限額。
執行已確認的交易 — 使用 cap_trade_execute 提交先前已預覽的持倉，並需明確確認，且須符合允許清單與規模上限。
列出未平倉部位 — 使用 cap_trade_positions_list 擷取目前持有部位，以檢視曝險並管理投資組合。
監控即時價格 — 透過 live_price_monitor 提示，為所選市場設定即時價格追蹤與警示。

文件

Capital.com MCP Server

用於 Capital.com 開放 API 的模型上下文協定（MCP）伺服器——讓 LLM 得以存取您的 Capital.com 交易帳戶。

⚠️ 重要通知

您使用 Capital.com 公開 API 及任何第三方工具（包括基於 AI/LLM 的工具），風險完全由您自行承擔。Capital.com 僅提供執行服務，不對第三方軟體或其結果背書或承擔任何責任。此處內容不構成投資建議。您需對您的交易決策負全部責任，包括因第三方工具引入延遲而導致的價格差異，並須遵守適用的條款與法律。

加密貨幣衍生品不適用於在 Capital Com (UK) Ltd 註冊的零售客戶。

在考慮真實交易之前，請務必先使用模擬帳戶
交易預設為停用，需要明確設定
所有交易操作皆需兩階段執行（預覽 → 確認 → 執行）
內建風險控管：白名單、規模限制、每日訂單上限
風險自負——作者不對交易損失承擔任何責任

如有進一步問題或需要釐清，請參閱常見問題（FAQ）：https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

快速入門指南

步驟 1：取得 Capital.com API 憑證

建立帳戶：前往 capital.com/trading/signup
- 選擇模擬帳戶進行測試（建議）
- 驗證您的電子郵件
啟用雙重驗證（2FA）：設定 > 安全性 > 雙重驗證
- 產生 API 金鑰前必須完成
產生 API 金鑰：設定 > API 整合 > 產生新金鑰
- 設定標籤（例如「MCP Server」）
- 設定自訂密碼（這不是您的平台密碼）
- 儲存顯示的 API 金鑰（僅顯示一次！）
- 請注意：API 金鑰具備交易功能；Capital.com 未提供唯讀金鑰

步驟 2：安裝與設定

AI 引導安裝： 在支援 AI 的編輯器（Claude Code、Cursor、Windsurf）中開啟此專案資料夾，並要求其安裝 Capital.com MCP 伺服器——它會依照 INSTALL.md 引導您完成設定，為您的環境選擇最佳方法。

您也可以選擇以下手動安裝方式：

選項 A：透過 MCPB 套件一鍵安裝（建議）

此儲存庫包含預先建置的 capital-mcp.mcpb 套件——在 Claude Desktop 中開啟即可完成，無需手動編輯設定。

步驟：

複製儲存庫：

git clone https://github.com/capital-com-sv/capital-mcp.git
cd capital-mcp

在 Claude Desktop 中開啟 capital-mcp.mcpb（雙擊，或將其拖入應用程式）。
Claude Desktop 會提示您輸入憑證（API 金鑰、識別碼、密碼）與交易控制設定。填寫完成後按一下「Install」。
重新啟動 Claude Desktop，並透過詢問「Capital.com 提供哪些工具？」來驗證。

選項 B：透過腳本手動安裝

前置需求： 必須安裝 Python 3.10+ 與 Git。

macOS：brew install python3 git
Ubuntu/Debian：sudo apt install python3 python3-venv git
Windows：python.org（安裝時勾選「Add to PATH」）+ git-scm.com

Mac/Linux：

cd /path/to/capital-mcp
./install.sh

Windows（PowerShell）：

cd C:\path\to\capital-mcp
pwsh install.ps1

安裝腳本會建立虛擬環境、安裝相依套件，並為您輸出 MCP 用戶端設定。

使用您的憑證編輯 .env：

# Required
CAP_ENV=demo
CAP_API_KEY=your_generated_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_api_password

# Trading controls (keep trading disabled until ready)
CAP_ALLOW_TRADING=false
CAP_ALLOWED_EPICS=

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

選項 C：Docker

前置需求： 必須安裝 Docker。

使用您的憑證建立 .env 檔案（請參閱 .env.example）：

CAP_ENV=demo
CAP_API_KEY=your_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_password
CAP_ALLOW_TRADING=false

執行伺服器：

docker run -i --rm --env-file .env ghcr.io/capital-com-sv/capital-mcp:latest

疑難排解：檢查日誌

如果您在使用 MCP 伺服器搭配 Claude Desktop 或其他用戶端時遇到問題，請檢查日誌檔案：

macOS：

# View MCP server logs
tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log

# Search for errors
grep -i error ~/Library/Logs/Claude/mcp-server-capital-com.log

Linux：

tail -f ~/.config/Claude/logs/mcp-server-capital-com.log

Windows：

Get-Content $env:APPDATA\Claude\logs\mcp-server-capital-com.log -Wait

用戶端整合

如需各用戶端的特定設定（Claude Desktop、Claude Code、Cursor、Windsurf、Codex、Docker、自訂用戶端），請參閱 USAGE.md — Client Integration。

使用範例

與 Claude Desktop 的對話範例

You: "Check my Capital.com session status"

Claude: I'll check your session status.
[Calls cap_session_status]
Response: {"ok": true, "data": {"env": "demo", "logged_in": false, ...}}

You're not currently logged in to the demo environment.

---

You: "Login to my Capital.com account"

Claude: I'll log you in.
[Calls cap_session_login]
Success! Logged in to account ID: ABC123

---

You: "Search for Bitcoin markets"

Claude: Searching for Bitcoin...
[Calls cap_market_search with search_term="Bitcoin"]
Found 5 markets:
- BTCUSD: Bitcoin vs US Dollar
- BTCEUR: Bitcoin vs Euro
- BTCGBP: Bitcoin vs British Pound
...

---

You: "Show me current positions"

Claude: Let me check your positions.
[Calls cap_trade_positions_list]
You have no open positions.

---

You: "Preview buying 1.0 SILVER"

Claude: I'll preview this trade. Note: Trading is currently DISABLED.
[Calls cap_trade_preview_position]
Preview failed: Trading is disabled (CAP_ALLOW_TRADING=false)

To enable trading, update your .env file:
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=SILVER

交易執行流程（啟用交易時）

1. Preview the trade (validates everything, no side effects):
   "Preview buying 2.0 SILVER with stop at 24.50"
   → Returns preview_id

2. Review the preview results:
   - Normalized size (rounded to broker increments)
   - Risk checks (allowlist, size limits, daily limits)
   - Estimated entry price

3. Execute ONLY if all checks pass:
   "Execute position with preview_id [id], confirm=true"
   → Creates real position
   → Returns deal_reference
   → Polls for broker confirmation

4. Monitor:
   "Show my positions"
   "Close position [deal_id] with confirm=true"

環境變數參考

必填

CAP_ENV - 環境：demo 或 live（預設：demo）
CAP_API_KEY - 來自 Capital.com 的 API 金鑰
CAP_IDENTIFIER - 登入電子郵件
CAP_API_PASSWORD - API 金鑰自訂密碼

風險控管（建議）

CAP_ALLOW_TRADING - 啟用交易（預設：false）
CAP_ALLOWED_EPICS - 以逗號分隔的白名單（例如「SILVER,GOLD,BTCUSD」）或「ALL」表示不限
CAP_MAX_POSITION_SIZE - 最大持倉規模（預設：1.0）
CAP_MAX_WORKING_ORDER_SIZE - 最大訂單規模（預設：1.0）
CAP_MAX_OPEN_POSITIONS - 最大同時持倉數（預設：3）
CAP_MAX_ORDERS_PER_DAY - 每日訂單上限（預設：20）
CAP_REQUIRE_EXPLICIT_CONFIRM - 要求 confirm=true（預設：true）
CAP_DRY_RUN - 封鎖所有交易執行（預設：false）

選填

CAP_DEFAULT_ACCOUNT_ID - 登入後的預設帳戶
CAP_HTTP_TIMEOUT_S - HTTP 逾時（預設：15）
CAP_LOG_LEVEL - 日誌等級：DEBUG、INFO、WARNING、ERROR（預設：INFO）

MCP 功能

共計 38 個工具涵蓋 6 大類別、7 個工作流程提示，以及 4 個唯讀資源。

類別	工具數	說明
工作階段	4	登入、登出、狀態、保持連線
市場資料	6	搜尋、詳細資料、價格、市場情緒、導覽
帳戶	6	列出帳戶、偏好設定、活動/交易歷史、模擬帳戶充值
交易	13	預覽、執行、平倉；列出/取消/修改掛單；確認
自選清單	6	建立、列出、取得、刪除自選清單；新增/移除市場
串流	3	透過 WebSocket 提供即時價格、警示、投資組合損益

提示	說明
`market_scan`	掃描自選清單中的交易條件
`trade_proposal`	以風險為基礎的規模規劃交易（僅預覽）
`execute_trade`	執行先前已預覽的交易
`position_review`	分析未平倉部位與曝險（唯讀）
`live_price_monitor`	即時價格追蹤並附價格變動警示（WebSocket）
`real_time_alerts`	條件價格位階警示（WebSocket）
`live_portfolio_monitor`	即時投資組合損益儀表板（WebSocket）

資源	說明
`cap://status`	伺服器健康狀態、工作階段狀態、速率限制
`cap://risk-policy`	風險管理設定與驗證層
`cap://allowed-epics`	交易白名單設定
`cap://market-cache/{epic}`	快取的市場詳細資料（即時擷取）

如需完整的詳細資料、參數與範例，請參閱 USAGE.md。

交易執行流程

強制兩步驟執行

所有具有副作用的操作皆採用嚴格的預覽 → 執行流程：

預覽：根據經紀商規則與本機風險政策驗證交易
- 回傳 preview_id，包含正規化請求與風險檢查
- 無副作用，唯讀驗證
執行：使用 preview_id 提交交易
- 重新執行關鍵檢查
- 若 CAP_REQUIRE_EXPLICIT_CONFIRM=true 則需要 confirm=true
- 輪詢經紀商確認
- 遞增每日訂單計數器

風險控管

白名單：僅可交易 CAP_ALLOWED_EPICS 中的 EPIC
規模限制：強制執行最大持倉/訂單規模
持倉限制：任何時間的最大未平倉部位數
每日限制：每日最大訂單數
規模正規化：四捨五入至經紀商的最小/最大/增量單位
乾跑模式：啟用時封鎖所有執行

文件

使用指南：USAGE.md - 含範例的完整使用指南
Capital.com API 參考：https://open-api.capital.com/
Capital.com API Postman 集合：https://github.com/capital-com-sv/capital-api-postman

授權

MIT

隱私權政策

Capital.com MCP 伺服器在您本機上執行，並使用您提供的憑證直接與 Capital.com 公開 API 通訊。它不是託管服務，也沒有自己的伺服器。

資料收集

MCP 伺服器不會收集或儲存任何資料。它僅作為您的 AI 用戶端與 Capital.com 公開 API 之間的本機橋接。

資料使用與儲存

工作階段期間交換的所有資料皆在您本機的記憶體中處理，並在工作階段結束時捨棄。MCP 伺服器不會將任何資料寫入磁碟。請注意：您的 AI 用戶端可能會依照其自身的隱私權政策處理、記錄或儲存透過其傳遞的資料，您應另行審閱該政策。

第三方分享

MCP 伺服器不會與任何第三方分享資料。資料僅在您的本機環境與 Capital.com 公開 API 之間流動，並受 Capital.com 自身的隱私權政策約束。

資料保留

MCP 伺服器不保留任何資料。工作階段資料僅在該工作階段期間存在於記憶體中。

API 憑證

您提供的 API 憑證會儲存並管理於您的本機環境中。您有責任妥善保護這些憑證。

聯絡方式

如有關於您的 Capital.com 帳戶或 Capital.com 如何處理您的資料之隱私相關問題，請參閱 Capital.com 隱私權政策或聯絡 support@capital.com。

免責聲明 – 將 Capital.com 公開 API 搭配第三方工具使用

第三方整合

此頁面說明用戶端如何將 Capital.com 公開 API 連接至第三方軟體、工具或整合，包括由人工智慧或大型語言模型（「LLM」）驅動的整合。任何此類第三方軟體、工具或整合均獨立於 Capital.com，且不構成 Capital.com 服務的一部分。Capital.com 不對任何第三方軟體、其功能、輸出或使用所產生的任何結果進行控制、開發、背書或承擔任何責任。任何將第三方工具或整合與 Capital.com 公開 API 搭配使用的行為，風險完全由您自行承擔。您有責任審閱您所選擇使用的任何第三方工具的條款、隱私權政策與資料處理實務。

公開 API 的使用

您使用 Capital.com 公開 API 的行為完全由您自行斟酌並自負風險。Capital.com 提供公開 API 供資訊與交易用途，但並不推薦、背書或鼓勵任何特定用途、整合或交易策略。您需對如何存取與使用 API 負全部責任，包括所提交任何訂單的參數、所連接任何工具或系統的設定，以及對所收到任何資料的詮釋。Capital.com 不對您使用 API（無論是直接存取或透過第三方工具）所導致的損失或非預期結果承擔任何責任。API 的可用性、功能與規格可能隨時修改、限速、暫停或終止，恕不另行通知。您使用公開 API 的行為須遵守 Capital.com 的條款與條件及電子交易條款，請在使用 API 前仔細閱讀。

僅提供執行服務且不提供投資建議

Capital.com 僅以執行服務為基礎提供服務。交易金融工具涉及重大損失風險。此頁面、公開 API 或任何第三方軟體或整合中的任何內容均不構成投資建議、個人推薦或購買或出售任何金融工具的邀約。這包括由 AI、基於 LLM 或其他自動化工具所產生的任何輸出、訊號、建議或分析。所有交易決策，包括任何自動化或演算法活動，均由您自行承擔風險，並仍由您負全部責任。Capital.com 不控制連接至公開 API 的第三方 AI 或基於 LLM 工具的輸出，也無法保證此類工具不會產生可能被解讀為投資建議或個人推薦的內容。任何此類輸出均非由 Capital.com 提供或代表 Capital.com 提供，不應作為建議依賴。

自動化與演算法交易的風險

將 Public API 與自動化或演算法交易工具搭配使用會帶來額外風險，包括但不限於：在無人為審查或介入的情況下快速執行訂單；系統錯誤、軟體故障或連線問題；以與預期價格顯著不同的價格執行；以及因工具或參數設定錯誤而導致的非預期或錯誤訂單。Capital.com 不對因該等風險或其系統與任何第三方工具之間的互動所產生的任何損失負責。過往表現及自動化工具產生的任何輸出均不保證未來結果。

若使用基於 AI 或 LLM 的工具來取得市場資料或價格資訊，工具所傳達的價格與任何後續訂單的執行價格之間可能存在延遲。透過 Public API 下的所有訂單均以市價單執行。因此，執行價格可能與提出請求時顯示的任何價格不同。Capital.com 依其義務力求達成最佳執行；我們不對因第三方工具或我們無法控制的系統所導致的延遲而產生的價格差異承擔責任。

禁止使用

不得將 Public API 及任何相關工具用於操縱 Capital.com 平台、利用價格或延遲、從事市場濫用行為，或取得任何不公平優勢。Capital.com 保留在其合理認為已發生或可能發生此類不當使用時，限制、暫停或終止 API 存取及/或您的帳戶的權利。客戶不得允許任何第三方對其帳戶行使自由裁量控制權。

您的責任

您有責任確保您對 Capital.com 平台、Public API 以及任何第三方工具或整合的使用，符合 Capital.com 的條款與條件、電子交易條款，以及您所在司法管轄區的所有適用法律與法規。在使用自動化交易工具之前，您應仔細考量這些工具是否適合您的個人情況、經驗與風險承受能力。Capital.com 強烈建議您在將任何自動化工具或整合連接到真實交易環境之前，先使用 Demo 帳戶進行徹底測試。