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
parent aab34a1fde
commit 896aa6111e
7 changed files with 979 additions and 93 deletions
@@ -0,0 +1,147 @@
+# VS Code 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
+cargo build --release
+```
+
+## Configure VS Code
+
+### Method 1: Command Palette (Recommended)
+
+1. Press `Cmd/Ctrl + Shift + P`
+2. Run `MCP: Add Server`
+3. Choose **Workspace** or **User** scope
+4. Enter server name: `mt5-quant`
+5. Enter command: Full path to binary (e.g., `/Users/name/mt5-quant/target/release/mt5-quant`)
+
+### Method 2: Edit mcp.json Directly
+
+Add to `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "servers": {
+    "mt5-quant": {
+      "command": "/absolute/path/to/mt5-quant"
+    }
+  }
+}
+```
+
+Create the file:
+
+```bash
+mkdir -p .vscode
+cat > .vscode/mcp.json << 'EOF'
+{
+  "servers": {
+    "mt5-quant": {
+      "command": "/path/to/mt5-quant"
+    }
+  }
+}
+EOF
+```
+
+### Method 3: VS Code CLI
+
+```bash
+code --add-mcp '{"name":"mt5-quant","command":"/path/to/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
+
+1. Open **Output** panel (`Cmd/Ctrl + Shift + U`)
+2. Select **MCP** from dropdown
+3. Check for connection errors
+4. Verify the path is absolute
+
+### Config not found
+
+The binary auto-detects its config, but you can also:
+1. Run `setup.sh` to create `config/mt5-quant.yaml`
+2. Or let the binary auto-discover on first run
+
+### Dev Container Setup
+
+Add to `.devcontainer/devcontainer.json`:
+
+```json
+{
+  "customizations": {
+    "vscode": {
+      "mcp": {
+        "servers": {
+          "mt5-quant": {
+            "command": "/path/to/mt5-quant"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Key Differences from Other IDEs
+
+VS Code uses `servers` (not `mcpServers`) in the JSON structure:
+
+```json
+{
+  "servers": {        // ← VS Code uses "servers"
+    "mt5-quant": {
+      "command": "..."
+    }
+  }
+}
+```
+
+Other platforms use `mcpServers`.
+
+## Resources
+
+- [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)
+- [MCP Configuration Reference](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration)
+- [MT5-Quant Tools Reference](./MCP_TOOLS.md)