Capital.com MCP

Capital.com MCP 服务

适用于 Capital.com Open API 的模型上下文协议（MCP）服务，可通过大模型驱动的方式访问您的 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. 启用 2FA：Settings > Security > Two-Factor Authentication

   • 生成 API 密钥前必须先启用

3. 生成 API 密钥：Settings > API integrations > Generate new key

   • 设置标签（例如，“MCP Server”）
   • 设置自定义密码（这不是您的平台密码）
   • 保存显示的 API 密钥（只会显示一次！）
   • 注意：API 密钥可用于交易；Capital.com 不提供只读密钥

第 2 步：安装和配置

**AI 引导安装：**在 AI 驱动的编辑器（Claude Code、Cursor、Windsurf）中打开此项目文件夹，并让它安装 Capital.com MCP 服务——它会按照 INSTALL.md 引导您完成设置，并为您的环境选择最佳方法。

您也可以选择以下手动安装方式：

选项 A：通过 MCPB Bundle 一键安装（推荐）

仓库中包含预构建的 capital-mcp.mcpb Bundle——在 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 密钥、标识符、密码）和交易控制设置。填写后点击 Install。
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（安装时勾选“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
[email protected]
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
   [email protected]
   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
   

故障排除：查看日志

如果在 Claude Desktop 或其他客户端中使用 MCP 服务时遇到问题，请查看日志文件：

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	实时投资组合盈亏仪表板

资源	描述
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 Public API 通信。它不是托管服务，也没有自己的服务器。

数据收集

MCP 服务不会收集或存储任何数据。它是您的 AI 客户端与 Capital.com Public API 之间的本地桥接程序。

数据使用和存储

会话期间交换的所有数据都在您的本地计算机内存中处理，并在会话结束时丢弃。MCP 服务不会将任何数据写入磁盘。请注意：您的 AI 客户端可能会根据其自身的隐私政策处理、记录或存储传递给它的数据，您应另行查阅该政策。

第三方共享

MCP 服务不会与任何第三方共享数据。数据仅在您的本地环境与 Capital.com Public API 之间流动，并受 Capital.com 自身隐私政策约束。

数据保留

MCP 服务不保留任何数据。会话数据仅在会话期间存储于内存中。

API 凭据

您提供的 API 凭据会在您的本地环境中存储和管理。您有责任妥善保护这些凭据。

联系

如需咨询与您的 Capital.com 账户或 Capital.com 如何处理您的数据相关的隐私问题，请参阅 Capital.com 隐私政策，或联系 [email protected]。

免责声明 – 通过第三方工具使用 Capital.com Public API

第三方集成

本页面介绍客户端如何将 Capital.com Public API 连接到第三方软件、工具或集成，包括由人工智能或大模型（“LLM”）驱动的软件、工具或集成。此类第三方软件、工具或集成均独立于 Capital.com，不属于 Capital.com 服务的一部分。Capital.com 不控制、开发或认可任何第三方软件，也不对其功能、输出或因使用而产生的任何结果承担责任。将第三方工具或集成与 Capital.com Public API 结合使用，完全由您自行承担风险。您有责任查阅所选第三方工具的条款、隐私政策和数据处理规范。

使用 Public API

您完全可以自行决定是否使用 Capital.com Public API，并自行承担风险。Capital.com 提供 Public API，用于信息查询和交易，但不推荐、认可或鼓励任何特定用途、集成或交易策略。您须对如何访问和使用 API 全权负责，包括提交的任何订单参数、任何已连接工具或系统的配置，以及对所接收数据的解读。无论您直接访问 API 还是通过第三方工具访问，Capital.com 均不对因使用 API 而造成的损失或意外后果承担责任。API 的可用性、功能和规范可能随时修改、限流、暂停或终止，恕不另行通知。使用 Public API 须遵守 Capital.com 的条款与条件及电子交易条款；使用 API 前，请仔细阅读。

仅提供执行服务，不提供投资建议

Capital.com 仅提供执行服务。金融工具交易涉及重大亏损风险。本页面、Public API 或任何第三方软件或集成中的内容，均不构成投资建议、个人推荐或买卖任何金融工具的邀约。这包括 AI、大模型或其他自动化工具生成的任何输出、信号、建议或分析。所有交易决策（包括任何自动化或算法交易活动）均由您自行承担风险，并由您独自负责。Capital.com 不控制连接到 Public API 的第三方 AI 或大模型工具的输出，也无法保证此类工具不会生成可能被视为投资建议或个人推荐的内容。任何此类输出均非由 Capital.com 提供或代表 Capital.com 提供，不应被视为建议而予以依赖。

自动化和算法交易的风险

将 Public API 用于自动化或算法交易工具会带来额外风险，包括但不限于：未经人工审核或干预而快速执行订单；系统错误、软件故障或连接问题；成交价格与预期存在重大差异；以及工具或参数配置错误导致的非预期或错误订单。Capital.com 不对因上述风险或其系统与任何第三方工具交互而造成的损失负责。过往表现以及自动化工具生成的任何输出，均不能代表未来结果。

使用 AI 或大模型工具获取市场数据或价格信息时，工具传达的价格与由此产生的订单实际执行价格之间可能存在延迟。通过 Public API 提交的所有订单均按市价单执行。因此，执行价格可能与请求时显示的价格不同。Capital.com 致力于根据自身义务实现最佳执行；对于因第三方工具或其控制范围之外的系统造成的延迟所导致的价格差异，我们不承担责任。

禁止用途

不得将 Public API 和任何连接的工具用于操纵 Capital.com 平台、利用价格或延迟、从事市场滥用或获取任何不公平优势。如果 Capital.com 有合理理由认为此类滥用已经发生或可能发生，则保留限制、暂停或终止 API 访问权限和／或您的账户的权利。客户不得允许任何第三方对其账户行使全权控制。

您的责任

您有责任确保使用 Capital.com 平台、Public API 以及任何第三方工具或集成的方式，符合 Capital.com 的《条款和条件》《电子交易条款》以及您所在司法管辖区的所有适用法律法规。在使用自动化交易工具之前，您应仔细考虑这些工具是否适合您的个人情况、经验和风险承受能力。Capital.com 强烈建议您先通过模拟账户充分测试任何自动化工具或集成，再将其连接到真实交易环境。