mcp-metatrader5-server

🚀 MetaTrader 5 MCP 服务器

MetaTrader 5 MCP 服务器是一个用于 MetaTrader 5 平台的 Model Context Protocol (MCP) 服务器，它能让 AI 助手与 MetaTrader 5 进行交互，实现交易操作和市场数据分析，为金融交易和分析带来便利。

✨ 主要特性

• 可连接到 MetaTrader 5 终端，为后续操作搭建桥梁。
• 能够访问市场数据，包括符号、汇率、tick 数据等，助力精准分析。
• 支持下单和管理交易，让交易操作更加便捷。
• 可以分析交易历史，为策略优化提供依据。
• 指导 AI 助手与用户互动，提升用户体验。

📦 安装指南

方式一：从 PyPI 安装

pip install mcp-metatrader5-server

方式二：从源代码安装

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-metatrader5-server.git
cd mcp-metatrader5-server

2. 安装依赖并构建包：

pip install -r requirements.txt
python -m build

💻 使用示例

基础用法

启动服务器

• 在开发者模式下启动：

python -m mcp_metatrader5_server.server --mode dev

• 以生产方式运行：

python -m mcp_metatrader5_server.server --mode prod

连接到 MetaTrader 5 并获取市场数据

from mcp_metatrader5_server import MarketData

md = MarketData()
symbol = "EUR_USD"
timeframe = "M15"

data = md.get_data(symbol, timeframe)
print(data)

高级用法

下单和管理交易

from mcp_metatrader5_server import Trading

trading = Trading(account_number="YOUR_ACCOUNT_NUMBER", password="YOUR_PASSWORD")

order_result = trading.open_order(symbol="EUR_USD", order_type="BUY", volume=0.1)
print(order_result)

positions = trading.get_positions()
print(positions)

📚 详细文档

资源

• MetaTrader 5 API 文档
• MCP 协议文档

提示

• connect_to_mt5(account, password, server): 连接到 MetaTrader 5 并登录
• analyze_market_data(symbol, timeframe): 分析指定符号的市场数据
• place_trade(symbol, order_type, volume): 下单交易指定符号
• manage_positions(): 管理未平仓头寸
• analyze_trading_history(days): 分析过去指定天数的交易历史

🔧 技术细节

项目结构

mcp-metatrader5-server/
├── src/
│   └── mcp_metatrader5_server/
│       ├── __init__.py
│       ├── server.py
│       ├── market_data.py
│       ├── trading.py
│       ├── main.py
│       └── cli.py
├── run.py
├── README.md
└── pyproject.toml

构建和发布

1. 安装构建工具：

pip install build twine

2. 构建包：

python -m build

3. 发布到 PyPI：

twine upload dist/*

📄 许可证

MIT License

致谢

• MetaQuotes 提供 MetaTrader 5 平台
• FastMCP 提供 MCP 服务器实现