Files

T

Devid HW 8f71f1629d docs: unify all docs to use single installation path ~/.local/bin/mt5-quant

- Update WINDSURF.md: Use registry name io.github.masdevid/mt5-quant
- Update CURSOR.md: Use ~/.local/bin/mt5-quant path
- Update QUICKSTART.md: Use standard path for all clients
- Update VSCODE.md: Use standard path
- Update setup.sh: Prefer ~/.local/bin/mt5-quant over project path
- Add fallback warning in setup.sh if project path used

Single source of truth: ~/.local/bin/mt5-quant

2026-04-22 05:17:20 +07:00

2.6 KiB

Raw Blame History

Cursor MCP Integration Setup

Quick Setup

Option 1: Download 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 2: Build from Source

cargo build --release

Configure Cursor

Method 1: Settings UI (Recommended)

Open Cursor Settings (Cmd/Ctrl + ,)
Navigate to Features → MCP
Click Add Custom MCP
Enter:
- Name: mt5-quant
- Command: ~/.local/bin/mt5-quant
- Type: stdio

Method 2: Edit mcp.json Directly

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

{
  "mcpServers": {
    "mt5-quant": {
      "type": "stdio",
      "command": "~/.local/bin/mt5-quant"
    }
  }
}

Create the file if it doesn't exist:

mkdir -p ~/.cursor
cat > ~/.cursor/mcp.json << 'EOF'
{
  "mcpServers": {
    "mt5-quant": {
      "type": "stdio",
      "command": "/path/to/mt5-quant"
    }
  }
}
EOF

Verify Setup

In Cursor 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
Global	`~/.cursor/mcp.json`	Available in all projects
Project	`.cursor/mcp.json`	Project-specific tools

Troubleshooting

MCP server not appearing

Check MCP panel in Cursor Settings
Verify the path is absolute (not relative)
Test binary: /path/to/mt5-quant --help
View MCP logs: Output panel → select "MCP" from dropdown

Config interpolation

Cursor supports variable substitution in mcp.json:

{
  "mcpServers": {
    "mt5-quant": {
      "command": "${userHome}/bin/mt5-quant",
      "args": ["--config", "${workspaceFolder}/config.yaml"]
    }
  }
}

Available variables:

${userHome} - Home directory
${workspaceFolder} - Project root
${workspaceFolderBasename} - Project folder name
${env:VAR_NAME} - Environment variable

Tool not found errors

If the agent says "Tool not found":

Check the server is enabled in MCP settings
Try disabling and re-enabling the server
Restart Cursor

2.6 KiB Raw Blame History