Capital.com Public API MCP Server

官方

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

GitHub

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

检查会话状态 — 让您的助手通过 capital-mcp.mcpb 验证您是否已登录 Capital.com 的模拟账户或真实账户。
搜索市场 — 让您的助手查找可交易工具（如比特币交易对），并返回其详情和当前价格。
预览交易 — 请求一份经过风险检查的交易预览（例如，“预览买入 1.0 SILVER”），该预览会验证数量和限额，但不会下达订单。
执行已确认的交易 — 指示您的助手使用其 preview_id 并附上明确确认，提交之前预览过的持仓。
列出未平仓头寸 — 让您的助手从您的 Capital.com 账户中显示当前未平仓头寸及其详情。
监控实时价格 — 通过 WebSocket 流式传输，为特定市场设置实时价格跟踪和提醒。

文档

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
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。

使用您的凭据创建 .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 — 客户端集成。

使用示例

与 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。

交易执行流程

强制两步执行

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

预览：根据经纪商规则和本地风险策略验证交易
- 返回 preview_id，包含规范化请求和风险检查
- 无副作用，仅只读验证
执行：使用 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）为基础提供服务。交易金融工具涉及重大亏损风险。本页面、公共 API 或任何第三方软件或集成中的任何内容均不构成投资建议、个人推荐或购买或出售任何金融工具的邀约。这包括由 AI、基于 LLM 或其他自动化工具生成的任何输出、信号、建议或分析。所有交易决策，包括任何自动化或算法活动，均由您自行承担风险，并完全由您自行负责。Capital.com 不控制连接到公共 API 的第三方 AI 或基于 LLM 的工具的输出，也无法保证此类工具不会生成可能被解读为投资建议或个人推荐的内容。任何此类输出均非由 Capital.com 提供或代表 Capital.com 提供，不应作为建议加以依赖。

自动化与算法交易的风险

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

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

禁止用途

不得将公共 API 及任何连接工具用于操纵 Capital.com 平台、利用定价或延迟漏洞、从事市场滥用行为或获取任何不公平优势。若 Capital.com 合理认为已发生或可能发生此类滥用行为，其保留限制、暂停或终止 API 访问权限及/或您账户的权利。客户不得允许任何第三方对其账户行使自由裁量控制权。

您的责任

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