Releases: shubhvisputek/meta-trader-mcp
v1.1.0
meta-trader-mcp v1.1.0
A large feature release on top of 1.0.2: 40+ new MCP tools (75 total) plus
two trading-path fixes. Cross-platform (Windows native / macOS·Linux via Wine /
remote bridge); trading stays OFF by default behind the risk interceptor.
✨ Added
- 75 tools + 4
mtm://resources + 3 prompts (was ~30). - Strategy analytics (Phase 3a): the MQL5
.setengine (read/write/patch/
diff/describe sweeps), deal-level backtest-report analytics
(analyze_backtest_report), and a SQLite report-history store (8 tools). - Wine-driving suite (Phase 3b):
compile_ea/validate_ea_syntax,
run_backtest/_quick/run_optimization, wine diagnostics/introspection,
cache + project scaffolding. - Live-data & analytics parity (Phase 4): candles by range/from, tick
history,check_orderpre-trade preview,scan_marketscreener, 10 indicators
(added Bollinger/ATR/Stochastic/ADX/CCI/Williams %R), risk/return analytics
(volatility, VaR/CVaR, correlation, seasonality), and MCP resources + prompts. - 342 mocked tests (~82% coverage), green on macOS/Linux/Windows × Py 3.10–3.12,
plus an opt-in live smoke suite driving every tool against a real MT5.
🐛 Fixed
- Order filling is symbol-aware — derives
type_fillingfrom
symbol_info.filling_mode(FOK > IOC > RETURN); fixes broker retcode 10030 on
FOK-only symbols forcheck_orderand the real order path. - Bulk close/cancel counts now report
{closed, attempted, failed}instead of
counting rejected closes as successes. - Windows CI green — cross-platform
Path.home(), deterministic rate-limit
test clock, forward-slash MQL5 logical paths.
Install: pip install meta-trader-mcp==1.1.0 · Full details in CHANGELOG.md.
v1.0.1
Slim release — same features, much lighter.
What changed
- Dropped the standalone
fastmcpdependency. The server uses the FastMCP bundled in the officialmcpSDK; the heavyweight package (and itscryptography/authlib/keyringsubtree) is now an opt-in[fastmcp]extra. pandasis now optional ([pandas]extra). It was only used by the vendored MT5Client dataframe helpers, never by the MCP tools or startup.- Result: the Claude Desktop
.mcpbbundle shrank from ~34 MB / 7,342 files to ~17–27 MB / ~2,150 files, so the one-click install no longer times out ("reply was never sent").pip installis faster and lighter too.
No tool or runtime behaviour changed.
Install
pip install meta-trader-mcp # PyPI (lean)
brew install shubhvisputek/tap/meta-trader-mcp # HomebrewClaude Desktop: download the .mcpb for your platform below (one-click), or point a config entry at the installed binary — see the README for both paths.
Docker: ghcr.io/shubhvisputek/meta-trader-mcp:1.0.1
⚠️ Trading is off by default. See DISCLAIMER.md.
v1.0.0
First release of meta-trader-mcp — a cross-platform Model Context Protocol server for MetaTrader 5.
Install
pip install meta-trader-mcp # macOS / Linux / Windows
pip install "meta-trader-mcp[windows]" # Windows: adds the MetaTrader5 bindingClaude Desktop (one click): download the .mcpb for your platform below and double-click it.
| Platform | Bundle |
|---|---|
| macOS (Apple Silicon) | meta-trader-mcp-macos-arm64.mcpb |
| Windows (x64) | meta-trader-mcp-windows-x64.mcpb |
| Linux (x64) | meta-trader-mcp-linux-x64.mcpb |
The .mcpb bundles carry all Python dependencies except the interpreter — they need python3 (3.10–3.12) on PATH.
Docker (remote-bridge companion): ghcr.io/shubhvisputek/meta-trader-mcp:1.0.0
Highlights
- One server, three runtimes:
windows-native,local-wine,remote-bridge. - Trading is off by default; every order passes a non-bypassable risk interceptor (max lot, equity-drawdown ceiling, payload guardrails, rate limiting).
- Lazy-connect: the server starts with no live MT5 connection and returns a structured
MT5_NOT_RUNNINGinstead of crashing. - 10 MCP tools: market data, indicators (SMA/EMA/RSI/MACD), order execution, position management, headless Strategy Tester backtests.
⚠️ This software can place real orders against a live account. See DISCLAIMER.md.
SHA256SUMS.txt lists checksums for every asset.