Capital.com MCP 服务器

已准备好投入生产的模型上下文协议用于与Capital.com交易API集成的(MCP)服务器。通过Claude Desktop、Cursor或任何MCP兼容的客户端交易货币、指数、商品等。

![License: MIT](https://opensource.org/licenses/MIT) ![Python 3.11+](https://www.python.org/downloads/) ](https://www.docker.com/)

⚡ 刚开始了解这个吗？ 查看一下 5分钟快速入门指南 →

______________________________________________________________________

⚠️ 重要免责声明

交易涉及重大财务风险。 此软件按“现状”提供，不附带任何保证。您需负责：

了解Capital.com的服务条款
遵守所在司法管辖区的金融法规
通过交易产生的任何损失
妥善管理您的交易账户风险

在进行实际交易之前，请务必先在Capital.com的模拟环境中进行练习。

______________________________________________________________________

🎯 特点

市场数据与分析

📊（表格） 搜索工具 - 查找交易对、指数、商品
📈 实时报价 - 获取当前的买/卖报价
📈 表示“上升趋势”或“增长”，常用于描述数据、价格、数值等的上升情况。 价格调查 - 同时监控多个仪器

账户管理

💰（钱的表情符号，无实际文字对应，可理解为“钱”或“金钱”的象征） 账户余额 - 查看可用资金及损益表
📋（清单/列表） 空缺职位 - 监控活跃交易
🔍 看起来像是放大镜或搜索的图标，没有具体的文字含义，可以理解为“放大镜”或“搜索”。 订单状态 - 跟踪订单执行情况

交易运营

🚀（火箭/快速上升/加速前进的符号） 市价单 - 按当前市场价格执行
🎯（瞄准目标） 限价订单 - 在特定价格水平执行
🛡️（盾形符号，常用于表示保护、防御等含义） 风险管理 - 止损、止盈、追踪止损
❌（表示错误或否定的符号，无直接对应中文含义，可理解为“错误”或“否”） 取消订单 - 平仓或取消挂单

安全特性

🟢（绿对勾，常表示正确、通过、成功或同意） 演示模式 默认情况下——无风险练习
🔐 实时交易保护 - 需要明确确认
⏱️（表示时间的计时器或倒计时） 速率限制 - 自动退避（100个请求/60秒）
🔒（锁形符号，通常表示安全、保密或锁定状态） 凭证安全 - 基于环境，从不硬编码

______________________________________________________________________

🤖 新功能：交易自动化堆栈

想要自动化您的交易策略吗？ 看看这个新东西 automation/ 文件夹！

生产级别的 自动化交易系统 构建于：

n8n - 可视化工作流自动化
PostgreSQL（译为“波斯特高斯奎尔”或直接保留原英文名，因其为专有名词） - 全面的贸易数据存储
人工智能集成 - 使用ChatGPT/Claude进行贸易评论与新闻情绪分析
“Multi-Armed Bandit”翻译成中文是“多臂老虎机”。这个术语常用于概率论和决策理论中，比喻在多个选项中做出选择，每个选项都有不同的收益和风险，类似于在老虎机中拉不同的臂（即选择不同的选项）会有不同的结果 - 动态策略选择
风险管理 - 投资组合限制、止损点、每日损失限额
技术指标 - 移动平均线（SMA）、相对强弱指数（RSI）、平均真实波幅（ATR）、成交量加权平均价格（VWAP）、唐奇安通道

特点：

📊 自动化数据收集与信号生成
🧠 基于人工智能的贸易评审与合理性检查
🎯 基于风险的仓位管理
🔐 用于安全的HMAC审批令牌
📈 性能追踪与策略优化
🚨 紧急断电开关 & 应急控制装置

👉 开始使用自动化 →

______________________________________________________________________

🚀 快速入门

一键安装

git clone https://github.com/JacquesKruger/Capital-MCP-Server.git && cd Capital-MCP-Server && ./install.sh

就是这样！安装程序将：

✅ 自动检测Docker或Python
✅ 安装所有依赖项
✅ 创建凭证模板
✅ 测试服务器
✅ 向您准确展示如何配置您的MCP客户端

手动安装（如您偏爱）

Click to expand manual installation steps

先决条件

Capital.com账户 从获取API凭据 Capital.com 开发者门户
Docker （建议使用）或 Python 3.11+
与MCP兼容的客户端 - Claude Desktop、Cursor 或类似工具

选项1：Docker

# Clone and build
git clone https://github.com/JacquesKruger/Capital-MCP-Server.git
cd Capital-MCP-Server
docker build -t capital-mcp-server .

# Add credentials
cp .env.example secrets/.env.demo
nano secrets/.env.demo  # Add your Capital.com credentials

选项2：Python

# Clone and setup
git clone https://github.com/JacquesKruger/Capital-MCP-Server.git
cd Capital-MCP-Server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Add credentials to secrets/.env.demo
cp .env.example secrets/.env.demo
nano secrets/.env.demo

______________________________________________________________________

🔧 配置

💡 提示： 这个（或“该”） install.sh 脚本会向您展示您系统的精确配置！

快速配置

跑步之后 ./install.sh安装程序将显示您的确切配置。只需将其复制粘贴到您的MCP客户端配置文件中，然后重启即可。

📖 Click for detailed configuration instructions

对于Claude Desktop

编辑： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "capital-trading": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--env-file", "/absolute/path/to/secrets/.env.demo", "capital-mcp-server"]
    }
  }
}

替换 /absolute/path/to/ 按照你实际的路径！

为Cursor（注：Cursor可能指某软件、工具或特定上下文中的概念，根据上下文具体翻译，此处保留原样以表示其专有名词性）

编辑： ~/.cursor/mcp.json

{
  "mcpServers": {
    "capital-trading": {
      "command": "/bin/bash",
      "args": ["/absolute/path/to/Capital-MCP-Server/run-mcp-server.sh"],
      "env": {"CAP_ENVIRONMENT": "demo"}
    }
  }
}

适用于Docker Desktop MCP工具包

见以获取分步指南。

______________________________________________________________________

📖 可用工具

工具	描述	参数
`check_status`	服务器状态和环境信息	无
`authenticate`	手动认证（自动处理）	无
`list_instruments`	搜索交易工具	`search_term`， `limit`
`get_quote`	获取当前价格报价	`epic`
`get_account_balance`	账户余额和资金	无
`get_positions`	查看空闲职位	无
`place_market_order`	执行市价单	`epic`， `direction`， `size`， `stop_loss`， `take_profit`， `trailing_stop`， `confirm_live_trade`\\*
`place_limit_order`	下限价单	`epic`， `direction`， `size`， `limit_level`， `stop_loss`， `take_profit`， `trailing_stop`， `confirm_live_trade`\\*
`get_order_status`	检查订单确认	`deal_reference`
`cancel_order`	平仓/取消订单	`deal_id`
`poll_prices`	查询多个仪器	`epic_list`， `interval_seconds`， `iterations`

\*可选的风险管理参数\ \*\*实时交易所需

______________________________________________________________________

💡 使用示例

市场数据

# In Claude/Cursor, use natural language:
"Search for EUR currency pairs"
"Get the current quote for EURUSD"
"Poll prices for EURUSD,US500,GOLD every 5 seconds"

交易（演示模式）

"Place a buy order for 100 units of EURGBP"
"Buy 50 EURUSD with stop-loss at 1.0950 and take-profit at 1.1050"
"Show my open positions"
"Close position with deal ID 12345"

风险管理

# Market order with protection
place_market_order(
    epic="EURGBP",
    direction="BUY",
    size="100",
    stop_loss="0.86364",      # 30 pips protection
    take_profit="0.87164"     # 50 pips target
)

______________________________________________________________________

🔐 安全

凭证管理

✅ 应该做：

存储凭据于 secrets/.env.demo 或者 secrets/.env.live
使用 chmod 600 关于凭证文件
定期轮换API密钥
使用演示模式进行测试

❌ 不要：

将凭据提交到Git
公开分享API密钥
在开发环境中使用真实凭据
跳过 confirm_live_trade 检查

实时交易安全

实时交易需要明确确认：

place_market_order(
    epic="EURUSD",
    direction="BUY",
    size="1",
    confirm_live_trade="yes"  # Required for live mode
)

______________________________________________________________________

📚 文档

readme.txt（文件名，可译为“阅读我.txt”或保持原样不翻译，因为文件名通常不翻译） - 完整的用户指南，附带示例
CLAUDE.md（文件名或标题，直译为“克劳德.md”，通常表示这是一个名为“克劳德”的Markdown格式文件） - 技术实现细节
**** - Docker Desktop 集成
《风险管理工作强化指南》.md - 止损/止盈指南
SERVER_STATUS.md 翻译为中文是：“服务器状态.md” - 当前服务器状态

______________________________________________________________________

🛠️ 开发

项目结构

Capital-MCP-Server/
├── capital_server.py          # Main MCP server
├── Dockerfile                 # Docker container config
├── requirements.txt           # Python dependencies
├── run-mcp-server.sh         # Server launcher script
├── secrets/                   # Credentials (gitignored)
│   ├── .env.demo             # Demo credentials
│   └── .env.live             # Live credentials
├── .gitignore                # Git exclusions
└── README.md                 # This file

运行测试

# Test MCP protocol
./test_server.py

# Test Docker container
./test_mcp.sh

# Manual test
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python capital_server.py

______________________________________________________________________

🤝 贡献（或：参与贡献）

欢迎投稿！请：

为仓库创建分支（或“克隆仓库”）
创建一个特性分支
在演示模式下测试
提交一个拉取请求

永远不要承诺：

凭据或API密钥
交易策略
个人账户信息

______________________________________________________________________

📄 许可证

此项目采用MIT许可证授权——详见许可证详情请查阅文件。

______________________________________________________________________

⚠️ 合规性监管

用户负责：

遵守Capital.com的服务条款
遵守其所在司法管辖区的金融法规
自动化交易的适当授权
风险管理与仓位规模设定

CFD交易风险警告： 差价合约（CFDs）是复杂的金融工具，由于杠杆效应，存在迅速亏损的高风险。请确保您了解差价合约的工作原理，并确认您是否能够承担亏损的高风险。

______________________________________________________________________

🔗 资源

Capital.com APIhttps://github.com/capital-com-sv/capital-api-postman 翻译为中文是：https://github.com/capital-com-sv/capital-api-postman（注：网址本身在中文语境下通常保持不变，不进行翻译，但这里为了说明其含义，可以理解为“资本公司API的Postman集合/示例/项目”，不过具体翻译可能需根据实际内容和用途调整）。如果仅需翻译网址中的文本部分（即网址前的说明），则“capital-api-postman”可以翻译为“资本API的Postman集合/示例/项目”等，但具体翻译需结合上下文。在实际应用中，网址通常保持原样
MCP协议https://modelcontextprotocol.io/（中文可译为：“模型上下文协议”官方网站）
FastMCP 框架https://github.com/jlowin/fastmcp 翻译为中文是：“https://github.com/jlowin/fastmcp（GitHub上的fastmcp项目）”。不过，通常在中文语境中，我们不会直接翻译网址，而是直接使用原网址，或者简单说明这是一个GitHub上的项目链接。所以，更自然的表达可能是：“这是GitHub上的fastmcp项目链接：https://github.com/jlowin/fastmcp”
风险管理指南见风险管理增强方案.md

______________________________________________________________________

📞 支持

问题使用 GitHub Issues 提交错误报告和功能请求
Capital.com API如需有关API的问题，请联系Capital.com客服支持
MCP协议查看MCP社区资源

______________________________________________________________________

🙏 致谢

Capital.com 提供交易API
用于协议开发的MCP社区
由杰夫·洛温（Jeff Lowin）开发的FastMCP框架

______________________________________________________________________

为MCP社区倾情打造

*记住：过去的表现并不能预示未来的结果。请负责任地进行交易。*

Capital MCP Server

快速接入

详细介绍

Capital.com MCP 服务器

⚠️ 重要免责声明

🎯 特点

市场数据与分析

账户管理

交易运营

安全特性

🤖 新功能：交易自动化堆栈

🚀 快速入门

一键安装

手动安装（如您偏爱）

先决条件

选项1：Docker

选项2：Python

🔧 配置

快速配置

对于Claude Desktop

为Cursor（注：Cursor可能指某软件、工具或特定上下文中的概念，根据上下文具体翻译，此处保留原样以表示其专有名词性）

适用于Docker Desktop MCP工具包

📖 可用工具

💡 使用示例

市场数据

交易（演示模式）

风险管理

🔐 安全

凭证管理

实时交易安全

📚 文档

🛠️ 开发

项目结构

运行测试

🤝 贡献（或：参与贡献）

📄 许可证

⚠️ 合规性监管

🔗 资源

📞 支持

🙏 致谢

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP