Capital.com Public API MCP Server

官方

Capital.com MCP服务器让您的AI助手直接与交易账户对话。市场数据、持仓检查、交易预览——全部使用自然语言，无需离开您的AI工具。

GitHub

试用此 MCP赞助

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

检查会话状态 — 在交易前，请让助手通过 cap_session_status 验证登录状态和环境。
搜索市场 — 使用 cap_market_search 查找可交易工具（如“Bitcoin”）并获取其 EPIC 代码。
预览交易 — 使用 cap_trade_preview_position 请求经过风险检查的交易预览，以在执行前验证规模和限额。
执行已确认的交易 — 使用 cap_trade_execute 提交先前预览过的仓位，需明确确认，并受允许列表和规模上限约束。
列出未平仓头寸 — 使用 cap_trade_positions_list 检索当前持仓，以审查风险敞口并管理投资组合。
监控实时价格 — 通过 live_price_monitor 提示为选定市场设置实时价格跟踪和警报。

文档

Capital.com MCP 服务器

面向 Capital.com 开放 API 的模型上下文协议（MCP）服务器——使基于 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 凭据

创建账户：前往 capital.com/trading/signup
- 选择模拟账户进行测试（推荐）
- 验证您的电子邮箱
启用双重身份验证（2FA）：设置 > 安全 > 双重身份验证
- 生成 API 密钥前必须完成此步骤
生成 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 中打开它即可完成，无需手动编辑配置。

步骤：

克隆仓库：

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

在 Claude Desktop 中打开 capital-mcp.mcpb（双击，或将其拖入应用）。
Claude Desktop 将提示您输入凭据（API 密钥、标识符、密码）和交易控制选项。填写完毕后点击安装。
重启 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 (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

故障排查：查看日志

如果在 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 - 启用交易（默认：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 能力

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。

交易执行流程

强制两步执行

所有具有副作用的操作均采用严格的预览 → 执行流程：

预览：根据经纪商规则和本地风险策略验证交易
- 返回 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 强烈建议您在将任何自动化工具或集成接入真实交易环境之前，先使用模拟账户进行充分测试。