docs: Move WINDSURF_SETUP.md to docs/WINDSURF.md

Consistent documentation structure - all docs now in docs/ directory. - Moved: WINDSURF_SETUP.md → docs/WINDSURF.md - Updated README.md link
2026-04-19 03:35:05 +07:00
parent 1461d9cd37
commit 61c5fd4dce
2 changed files with 1 additions and 0 deletions
@@ -0,0 +1,89 @@
+# Windsurf MCP Integration Setup
+
+## Quick Setup
+
+### Option 1: Download Prebuilt Binary (Recommended)
+
+```bash
+# 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
+
+```bash
+bash scripts/build-rust.sh
+```
+
+### 2. Configure Windsurf
+
+Edit `~/.windsurf/config.yaml`:
+
+```yaml
+mcpServers:
+  mt5-quant:
+    command: /Users/masdevid/jobs/mt5-quant/target/release/mt5-quant
+    env:
+      MT5_MCP_HOME: /Users/masdevid/jobs/mt5-quant
+```
+
+### 3. Restart Windsurf
+Close and reopen Windsurf to load the MCP server.
+
+### 4. Verify
+In Windsurf chat, test with:
+```
+Run verify_setup
+```
+
+## Deployment to Multiple Machines
+
+### Build for Distribution
+```bash
+# Build release binary
+cargo build --release
+
+# Create tarball
+tar -czf mt5-quant-macos-arm64.tar.gz -C target/release mt5-quant
+
+# Deploy to remote server
+scp mt5-quant-macos-arm64.tar.gz user@server:~/
+ssh user@server "tar -xzf mt5-quant-macos-arm64.tar.gz -C /opt/"
+ssh user@server "ln -s /opt/mt5-quant /usr/local/bin/"
+
+# Copy config
+scp -r config/mt5-quant.yaml user@server:~/.config/mt5-quant/config/
+```
+
+### Target Machine Requirements
+- MetaTrader 5 installed (via Wine/CrossOver)
+- Config file at `~/.config/mt5-quant/config/mt5-quant.yaml`
+- **NO Python required!**
+
+### Windsurf Config on Target Machine
+```yaml
+mcpServers:
+  mt5-quant:
+    command: /usr/local/bin/mt5-quant
+```
+
+## Troubleshooting
+
+### MCP server not appearing
+1. Check Windsurf logs: `~/.windsurf/logs/`
+2. Verify executable path is absolute
+3. Test executable manually: `./target/release/mt5-quant --help`
+
+### Config not found
+Set `MT5_MCP_HOME` environment variable or ensure config is at default location:
+- macOS: `~/.config/mt5-quant/config/mt5-quant.yaml`
+
+### Permission denied
+```bash
+chmod +x /path/to/mt5-quant
+```