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 服务器实现