Capital.com Public API MCP Server

Capital.com MCP 伺服器

Model Context Protocol (MCP) 伺服器，用於 Capital.com 開放 API——讓 LLM 驅動的存取您的 Capital.com 交易帳戶。

⚠️ 重要通知

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

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

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

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

快速入門指南

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

1. 建立帳戶：前往 capital.com/trading/signup

   • 選擇模擬帳戶進行測試（建議）
   • 驗證您的電子郵件

2. 啟用雙重驗證：設定 > 安全性 > 雙重驗證

   • 產生 API 金鑰前必須完成此步驟

3. 產生 API 金鑰：設定 > API 整合 > 產生新金鑰

   • 設定標籤（例如「MCP 伺服器」）
   • 設定自訂密碼（這不是您的平台密碼）
   • 儲存顯示的 API 金鑰（僅顯示一次！）
   • 注意：API 金鑰具備交易權限；Capital.com 不提供唯讀金鑰

步驟 2：安裝與設定

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

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

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

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

步驟：

1. 複製儲存庫：

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

2. 在 Claude Desktop 中開啟 capital-mcp.mcpb（雙擊，或將其拖入應用程式）。
3. Claude Desktop 會提示您輸入憑證（API 金鑰、識別碼、密碼）和交易控制項。填寫後按一下「安裝」。
4. 重新啟動 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（安裝時勾選「加入 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
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=ALL

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# Narrow the allowlist to the instruments you actually trade
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

選項 C：Docker

先決條件： 必須安裝 Docker。

1. 使用您的憑證建立 .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
   

2. 執行伺服器：

   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 — 用戶端整合。

使用範例

與 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 - 啟用交易（預設：true）
• CAP_ALLOWED_EPICS - 允許交易的金融工具（預設：ALL，所有金融工具）。使用逗號分隔清單限制，例如「SILVER,GOLD,BTCUSD」。留空則封鎖所有交易
• 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 功能

6 個類別共 38 個工具、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。

交易執行流程

強制兩步驟執行

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

1. 預覽：根據經紀商規則 + 本機風險政策驗證交易

   • 傳回 preview_id，包含正規化請求 + 風險檢查
   • 無副作用，唯讀驗證

2. 執行：使用 preview_id 提交交易

   • 重新執行關鍵檢查
   • 若 CAP_REQUIRE_EXPLICIT_CONFIRM=true 則需要 confirm=true
   • 輪詢經紀商確認
   • 增加每日訂單計數器

風險控制

• 允許清單：只能交易 CAP_ALLOWED_EPICS 中的 EPIC；預設的 ALL 允許所有金融工具
• 規模限制：強制執行最大持倉/訂單規模
• 持倉限制：任何時間的最大未平倉部位數
• 每日限制：每日最大訂單數
• 規模正規化：四捨五入至經紀商的最小/最大/增量
• 乾執行模式：啟用時封鎖所有執行

文件

• 使用指南：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 以僅執行（execution-only）為基礎提供服務。交易金融工具涉及重大虧損風險。本頁面、Public API 或任何第三方軟體或整合中的任何內容，均不構成投資建議、個人推薦或買賣任何金融工具的要約。這包括由 AI、基於 LLM 或其他自動化工具產生的任何輸出、訊號、建議或分析。所有交易決策，包括任何自動化或演算法活動，均由您自行承擔風險，並由您全權負責。Capital.com 不控制連接到 Public 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 帳戶進行徹底測試。