Files

T

Devid HW 74c3fdb87e docs: fix binary paths and tarball names across all documentation

Updated files:
- README.md: Fix tarball filename mt5-quant -> mcp-mt5-quant
- QUICKSTART.md: Fix tarball names and all binary paths
- WINDSURF.md: Fix tarball names, binary paths, and install script paths
- CURSOR.md: Fix tarball names and all binary path references
- VSCODE.md: Fix tarball names and all binary path references

All paths now correctly point to:
- Prebuilt: /path/to/mt5-quant/mcp-server/bin/mt5-quant
- Dev build: /path/to/mt5-quant/target/release/mt5-quant

2026-04-22 08:45:06 +07:00

3.0 KiB

Raw Permalink Blame History

VS Code MCP Integration Setup

Quick Setup

Option 1: Download Prebuilt Binary (Recommended)

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

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

Option 2: Build from Source

cargo build --release

Configure VS Code

Method 1: Command Palette (Recommended)

Press Cmd/Ctrl + Shift + P
Run MCP: Add Server
Choose Workspace or User scope
Enter server name: mt5-quant
Enter command: /path/to/mt5-quant/mcp-server/bin/mt5-quant

Method 2: Edit mcp.json Directly

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

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

Create the file:

mkdir -p .vscode
cat > .vscode/mcp.json << 'EOF'
{
  "servers": {
    "mt5-quant": {
      "command": "/path/to/mt5-quant/mcp-server/bin/mt5-quant"
    }
  }
}
EOF

Method 3: VS Code CLI

code --add-mcp '{"name":"mt5-quant","command":"/path/to/mt5-quant/mcp-server/bin/mt5-quant"}'

Verify Setup

In Copilot chat, type:

Run verify_setup

Expected output:

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

Configuration Locations

Scope	Path	Use Case
Workspace	`.vscode/mcp.json`	Share with team via source control
User	`~/.vscode/mcp.json`	Personal tools across all projects
Dev Container	`devcontainer.json` → `customizations.vscode.mcp`	Containerized environments

Troubleshooting

MCP server not appearing

Open Output panel (Cmd/Ctrl + Shift + U)
Select MCP from dropdown
Check for connection errors
Verify the path is absolute

Config not found

The binary auto-detects its config, but you can also:

Run setup.sh to create config/mt5-quant.yaml
Or let the binary auto-discover on first run

Dev Container Setup

Add to .devcontainer/devcontainer.json:

{
  "customizations": {
    "vscode": {
      "mcp": {
        "servers": {
          "mt5-quant": {
            "command": "/path/to/mt5-quant/mcp-server/bin/mt5-quant"
          }
        }
      }
    }
  }
}

Key Differences from Other IDEs

VS Code uses servers (not mcpServers) in the JSON structure:

{
  "servers": {        // ← VS Code uses "servers"
    "mt5-quant": {
      "command": "..."
    }
  }
}

Other platforms use mcpServers.

3.0 KiB Raw Permalink Blame History