Ctrader MCP Server

cTrader MCP 服务器

一个独立的模型上下文协议（MCP）服务器，使AI助手能够与cTrader交易平台进行交互。

🚀 这是什么？

这款MCP服务器允许像Claude这样的AI助手通过自然语言对话在cTrader上执行交易、分析市场以及管理仓位。

示例对话：

• *“显示我的账户余额”* → 获取余额、权益、仓位
• *“以1.08为止损点，买入0.01手EURUSD”* → 进行交易
• *“计算GBPUSD的相对强弱指数（RSI）”* → 分析技术指标
• *“平掉所有亏损仓位”* → 管理风险

✨ 特点

交易运营

• ✅ 市价单 - 立即以当前价格执行
• ✅ 限价订单 - 在特定价格水平下单
• ✅ 表示“正确”或“完成”。 止损订单 - 止损或止盈/止损限价单
• ✅ 位置管理 - 全部或部分平仓
• ✅ 订单管理 - 取消待处理订单

市场数据与分析

• ✅ 表示“正确”或“已确认”。 历史数据 - OHLCV蜡烛图（9个时间框架：1分钟、5分钟、15分钟、30分钟、1小时、4小时、1天、1周、1月）
• ✅ 技术指标 - 相对强弱指数（RSI），移动平均收敛散度指标（MACD），指数移动平均线（EMA），简单移动平均线（SMA），布林带（Bollinger Bands），平均真实波幅（ATR），随机指标（Stochastic）
• ✅ 实时行情报价（或实时交易记录） - 订阅实时价格数据流
• ✅ 符号搜索 - 浏览100多种交易工具

账户信息

• ✅ 账户状态 - 账户余额、权益、保证金、可用保证金
• ✅ 位置追踪 - 所有持仓及盈亏情况
• ✅ 订单追踪 - 所有待处理订单
• ✅ 损益分析 - 详细的盈亏明细

🎯 可用工具（共14个）

📋 先决条件

• Python 3.10 或更高版本
• 一个cTrader账户（模拟或真实）
• cTrader API 凭证

🔧 安装

获取cTrader API凭据

1. 访问 https://help.ctrader.com/open-api/creating-new-app/（创建新应用程序的开放API页面）
2. 创建一个应用程序以获取：

- CLIENT_ID - CLIENT_SECRET

1. 生成一个访问令牌：

- ACCESS_TOKEN

1. 在cTrader中找到您的账户ID：

- ACCOUNT_ID

2. 安装服务器

# Clone or download this repository
cd ctrader-mcp-server

# Run installation script
./install.sh

3. 配置凭据

创建一个 .env 项目根目录下的文件：

CLIENT_ID=your_client_id_here
CLIENT_SECRET=your_client_secret_here
ACCESS_TOKEN=your_access_token_here
ACCOUNT_ID=your_account_id_here
HOST=demo

重要提示： 使用 HOST=demo 用于测试！

4. 测试服务器

# Activate virtual environment
source venv/bin/activate

# Run tests
python test_server.py

你应该看到：

✓ Bot initialized and authenticated
✓ Account status retrieved
✓ Found X EUR symbols
...
All Tests Completed Successfully! ✓

🤖 配置AI助手

Claude Desktop（克劳德桌面版）

1. 找到你的配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Windows： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 添加此配置：

{
  "mcpServers": {
    "ctrader": {
      "command": "/absolute/path/to/ctrader-mcp-server/venv/bin/python",
      "args": [
        "/absolute/path/to/ctrader-mcp-server/server.py"
      ],
      "cwd": "/absolute/path/to/ctrader-mcp-server"
    }
  }
}

1. 重启Claude桌面版

其他MCP客户端

此服务器实现了标准的MCP协议，应能与任何兼容MCP的客户端正常工作。

💬 示例对话

一旦配置完成，您就可以进行自然交互：

检查账户：

你：“我的cTrader账户里有多少钱？” AI：“您的账户余额为10,000美元，权益为10,250美元，当前有3个未平仓头寸，总盈亏为+250美元。”

交易地点：

你：“买入0.01手欧元兑美元，止损价设为1.08，止盈价设为1.10。” AI：“订单已执行！以1.09245的价格买入0.01手EURUSD，止损位设为1.08000，止盈位设为1.10000。”

分析市场：

你：“请计算GBPUSD在15分钟图表上的相对强弱指数（RSI）” AI：“GBPUSD在15分钟线上的RSI(14)指标目前为65.3，表明该货币对正接近超买区域。”

管理风险：

你：“平掉所有亏损超过50美元的仓位” AI：“发现1个仓位亏损超过50美元。已平仓GBPUSD（亏损：-62.50美元）。”。“

📚 文档

• 快速入门指南 - 5分钟内快速上手
• 完整指南 - 综合参考
• 建筑 - 技术细节
• 配置 - 设置选项
• API 参考文档 - 所有工具均已记录在案

🔐 安全与保障

模拟交易与实盘交易

• 默认配置使用 模拟账户
• 明确设置 HOST=live 在 .env 用于实时交易
• 在正式上线前，务必在演示环境中进行充分测试

风险管理

• 所有订单均支持止损和止盈
• 平仓可以是部分平仓或全部平仓
• 交易手数以手为单位指定（0.01 = 微手）

凭证安全

• 存储在（某处）的凭据 .env 文件（从未提交）
• 环境变量从不在日志中暴露
• 在操作之前验证了认证状态

🚨 重要警告

⚠️（表示警告或注意的符号） 交易蕴含重大风险，您可能会损失资金。\ ⚠️ 务必先在模拟账户上进行测试\ ⚠️ 实盘交易时从小仓位开始\ ⚠️（警告或注意的符号，无具体文字含义） 使用止损单来限制风险\ ⚠️ 永远不要分享你的凭证或访问令牌

🛠️ 开发

项目结构

ctrader-mcp-server/
├── server.py              # Main MCP server
├── ctrader_bot.py         # cTrader API wrapper
├── test_server.py         # Testing tool
├── install.sh             # Installation script
├── requirements.txt       # Python dependencies
├── .env.example           # Environment template
├── README.md              # This file
└── docs/                  # Documentation
    ├── QUICKSTART.md
    ├── GUIDE.md
    ├── ARCHITECTURE.md
    ├── CONFIGURATION.md
    └── API.md

运行测试

# Basic functionality test
python test_server.py

# Run with specific account
ACCOUNT_ID=12345 python test_server.py

# Test with live account (careful!)
HOST=live python test_server.py

添加新工具

添加新工具：

1. 在（某处）添加工具定义 server.py handle_list_tools()
2. 在（某处）实现处理程序 _execute_tool()
3. 添加相应的方法到 ctrader_bot.py 如有需要
4. 更新文档

📊 性能

• 启动时间： 5-10秒（认证+符号加载）
• 订单执行： \<100毫秒（市价订单）
• 历史数据： 1-5秒（100根蜡烛）
• 指标计算： \< 1秒
• 内存使用情况： 50-100 MB

🌐 请求速率限制

cTrader API强制执行：

• 每秒50个请求 用于交易操作
• 每秒5个请求 用于历史数据

服务器会自动遵守这些限制。

🐛 故障排除

“机器人未准备好”错误

• 检查 .env 文件凭证
• 验证网络连接
• 确保cTrader账户处于活跃状态
• 检查服务器日志中的认证错误

符号未找到

• 使用 list_symbols 查看可用符号的工具
• 符号名称区分大小写
• 不同的经纪人可能有不同的符号名称

订单被拒绝

• 检查账户余额和保证金
• 验证该符号是否可交易
• 确保音量达到最低要求
• 检查市场是否开放

连接问题

• 验证API凭据是否正确
• 检查账户是否处于活跃状态
• 确保没有防火墙阻止端口5035（演示）或5034（实时）

🔗 资源

• cTrader开放API文档
• 模型上下文协议
• cTrader Python SDK（cTrader Python软件开发工具包）

📄 许可证

MIT 许可证 - 详见 LICENSE 文件

⚖️ 免责声明

本软件按“现状”提供，不附带任何形式的保证。交易存在重大风险，您可能会损失资金。使用风险自担。在实际交易前，请务必在模拟账户上进行测试。

🤝 贡献

欢迎投稿！请：

1. 为仓库创建分支
2. 创建一个特性分支
3. 做出你的更改
4. 如适用，请添加测试
5. 提交拉取请求

📧 支持

• 📖 检查一下 文件、文档
• 🐛 在GitHub上报告问题
• 💬 加入 cTrader 社区

______________________________________________________________________

专为算法交易者打造，倾注爱心

准备开始了吗？ 跑步 ./install.sh 并按照上面的指示操作！