Files

T

Devid HW 896aa6111e feat: auto-detect and register MCP on multiple platforms

- Add multi-platform MCP detection (Claude, Windsurf, Cursor, VS Code)
- Auto-unregister previous installations before reinstall
- Create platform-specific docs (CURSOR.md, VSCODE.md, ANTIGRAVITY.md)
- Update Windsurf config to use correct JSON path (~/.codeium/windsurf/mcp_config.json)
- Fix VS Code config format (uses 'servers' not 'mcpServers')
- Remove MT5_MCP_HOME requirement from MCP configs (binary auto-detects)
- Slim down README installation section with platform table
- Update QUICKSTART.md with all platform instructions

2026-04-20 00:40:41 +07:00

3.6 KiB

Raw Blame History

Quickstart Guide

1. Download or Build

Option A: Prebuilt Binary (Recommended)

# macOS (Apple Silicon)
curl -L -o mt5-quant.tar.gz https://github.com/masdevid/mt5-mcp/releases/latest/download/mt5-quant-macos-arm64.tar.gz
tar -xzf mt5-quant.tar.gz

# Linux (x64)
curl -L -o mt5-quant.tar.gz https://github.com/masdevid/mt5-mcp/releases/latest/download/mt5-quant-linux-x64.tar.gz
tar -xzf mt5-quant.tar.gz

Option B: Build from Source

git clone https://github.com/masdevid/mt5-mcp
cd mt5-mcp
bash scripts/build-rust.sh

2. Install MetaTrader 5

macOS - MetaTrader 5.app (Free)

Download from metatrader5.com
Install to /Applications
Launch once to initialize Wine prefix (~30s), then quit

Auto-detected paths:

Wine: /Applications/MetaTrader 5.app/Contents/SharedSupport/wine/bin/wine64
MT5: ~/Library/Application Support/net.metaquotes.wine.metatrader5/drive_c/Program Files/MetaTrader 5

macOS - CrossOver (Paid, Better Compatibility)

Install CrossOver
Create bottle MetaTrader5
Install MT5 inside bottle

Auto-detected paths:

Wine: /Applications/CrossOver.app/Contents/SharedSupport/CrossOver/bin/wine64
MT5: ~/Library/Application Support/MetaQuotes/<hash>/drive_c/Program Files/MetaTrader 5

Linux

# Debian/Ubuntu
sudo apt install wine64 xvfb

# Fedora/RHEL
sudo dnf install wine xorg-x11-server-Xvfb

# Install MT5
wine64 MetaTrader5Setup.exe

MT5 location: ~/.wine/drive_c/Program Files/MetaTrader 5

3. Configure

Run the setup script to auto-detect paths:

bash scripts/setup.sh          # interactive
bash scripts/setup.sh --yes    # non-interactive (CI)

This creates config/mt5-quant.yaml (gitignored).

Minimum config:

wine_executable: "/Applications/MetaTrader 5.app/Contents/SharedSupport/wine/bin/wine64"
terminal_dir: "~/Library/Application Support/net.metaquotes.wine.metatrader5/drive_c/Program Files/MetaTrader 5"

4. Register MCP Server

Claude Code

claude mcp add MT5-Quant -- /path/to/mt5-quant/target/release/mt5-quant

Verify:

claude mcp list

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mt5-quant": {
      "command": "/path/to/mt5-quant"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "mt5-quant": {
      "command": "/path/to/mt5-quant"
    }
  }
}

Or use Settings → MCP → Add Custom MCP.

VS Code

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "mt5-quant": {
      "command": "/path/to/mt5-quant"
    }
  }
}

Or run MCP: Add Server from Command Palette.

Antigravity

Open Agent panel → Click "..." menu → MCP Servers
Click "Manage MCP Servers"
Click "View raw config" or "Edit configuration"
Add to mcp_config.json:

{
  "mcpServers": {
    "mt5-quant": {
      "command": "/path/to/mt5-quant"
    }
  }
}

Reload Antigravity to apply changes

5. Verify Setup

bash scripts/platform_detect.sh

Or in Claude/Windsurf:

Run verify_setup

Expected output:

Wine:    /Applications/MetaTrader 5.app/.../wine64
MT5 dir: ~/Library/Application Support/.../MetaTrader 5
Display: gui
Arch:    arch -x86_64

6. Run First Backtest

Run a backtest on MyEA from 2025.01.01 to 2025.03.31

The AI will:

Verify setup
Compile your EA
Clean MT5 cache
Run backtest
Extract and analyze results
Report key findings

Next: See TOOLS.md for all 43 available tools.

3.6 KiB Raw Blame History