MetaTrader5 的 MCP 服务器，提供市场数据和技术指标

mtdata

它以模型上下文协议（MCP）服务器还是独立服务器CLI.

这是给谁的？

• 新手交易者/学习者：遵循指导的工作流程（无需定量背景）。
• 系统性交易者：原型想法，快速回测，并通过CLI/MCP实现自动化。
• 数据专家：将MT5市场数据导入可重复的分析流程。

平台支持（重要）

• 必须有窗户 to run MetaTrader 5 (and therefore to run mtdata against MT5).
• If you're on macOS/Linux, run mtdata on a Windows 虚拟机或 Windows 机器并实现远程连接（MCP/Web API）。
• Python 3.14 是支持的运行时对于该仓库中的封装依赖集合。

安全第一

• mtdata includes trade_* commands that can 下放/修改/关闭真实订单在目前登录MT5的账户上。
• Use a 演示账户直到你了解工具和经纪人设置。
• mtdata 没有内置的“纸币交易”模式;使用MT5演示账号进行模拟执行。
• If you only want research, stick to data_, forecast_, regime_, patterns_, and report_* commands.

Capabilities

快速入门

Prerequisites: Windows + Python 3.14 + MetaTrader 5 installed and running (demo account recommended).

# Lean core install
pip install -e .

# Full research/web install
pip install -r requirements.txt

# Verify MT5 connection (lists symbols from the running terminal)
mtdata-cli symbols_list --limit 5

# Scan the current MT5 watchlist for top markets
mtdata-cli symbols_top_markets --rank-by all --limit 5 --timeframe H1

# Fetch recent candles
mtdata-cli data_fetch_candles EURUSD --timeframe H1 --limit 50

# Generate a baseline price forecast
mtdata-cli forecast_generate EURUSD --timeframe H1 --horizon 12 --method theta

Notes:

• pip install -e . now installs the lean core package only.
• pip install -r requirements.txt installs the full validated Python 3.14 stack, including Chronos/TimesFM, StatsForecast, sktime, mlforecast, and the Web API.
• gluonts/Lag-Llama, hnswlib, and tsdownsample are intentionally excluded from the default 3.14 environment because current wheel support is incomplete or incompatible.

Documentation

新来的？请遵循以下学习路径：
docs/SETUP.md → docs/GLOSSARY.md → docs/CLI.md → docs/SAMPLE-TRADE.md (then docs/SAMPLE-TRADE-ADVANCED.md and deep dives).

入门指南

• 设置与配置— 安装、MT5连接、环境变量
• CLI 指南— 命令约定、输出格式、帮助系统
• Glossary— 所有专业术语的解释及现实世界的示例
• 文档索引——所有文档的一页地图

核心主题

• Forecasting— 价格预测方法（Theta、ARIMA、Chronos等）
• Volatility——估算价格变动幅度
• 政权检测— 识别市场状态（趋势与波动）
• 障碍分析— TP/SL命中概率计算
• 技术指标— 可用指标和使用情况
• Denoising— 平滑滤波器以揭示趋势
• 模式检测—— 蜡烛和图表图案
• 时间分析— 会话效应、星期几和季节模式

外部数据与选项

• Finviz 基础—— 美国股市数据、放映、新闻、日历
• 期权与量化自由——期权链、障碍定价、赫斯顿校准

Tutorials

• 示例交易工作流程——贸易决策的逐步分析
• 高级操作手册—— 态滤波器、共形区间、势垒优化
• 端到端示例—— 包含所有工具的完整研究循环

Reference

• Web API— Web 界面和集成的 REST 端点
• Troubleshooting——常见问题与修复方法

Configuration

Create a .env file in the project root:

MT5_LOGIN=12345678
MT5_PASSWORD=your_password
MT5_SERVER=your_broker_server
MT5_TIME_OFFSET_MINUTES=0  # Adjust if broker server time differs from UTC

Architecture

mtdata/
├── src/mtdata/
│   ├── core/           # Tool registry, schemas, server logic, all 52 MCP tools
│   ├── forecast/       # Forecasting methods, engines, and method registry
│   ├── patterns/       # Pattern detection algorithms
│   ├── services/       # MT5 data access, Finviz, options data
│   └── utils/          # Shared utilities (indicators, denoising, etc.)
├── webui/              # React + Vite frontend
├── docs/               # Documentation
└── tests/              # Test suite

License

MIT

文章来源：https://github.com/emerzon/mt-data-mcp