CURSOR_MCP_SETUP_GUIDE.md

# 🚀 Cursor IDE MCP Integration Guide

**Add Echo Prime MCP Servers to Cursor IDE for AI-powered development**

## 🎯 What You'll Get

After setup, you'll have access to:
- **🧮 Echo Prime**: Mathematical reasoning, AI benchmarking, code analysis
- **🧬 QuLab Infinite**: Materials science, quantum simulations, molecular dynamics
- **🌌 Achlys Systems**: Cognitive AI, consciousness processing, multi-aspect reasoning
- **⚖️ Legal AI**: Contract analysis, compliance checking (when available)

## 📋 Prerequisites

### 1. **MCP SDK Installation**
```bash
pip install mcp
```

### 2. **Cursor IDE**
- Ensure you have Cursor IDE installed
- Version should support MCP (latest versions do)

### 3. **Python Environment**
- Python 3.11+ recommended
- All dependencies installed in your environment

## 🚀 Quick Setup (3 Steps)

### Step 1: Start MCP Servers
```bash
# Navigate to your project directory
cd /Users/noone/echo_prime

# Start all MCP servers
python start_mcp_servers.py
```
**Leave this terminal running** - it will show server status.

### Step 2: Configure Cursor IDE

#### Option A: Import Configuration File
1. **Open Cursor IDE**
2. **Go to Settings** → **MCP Servers**
3. **Click "Import from JSON"**
4. **Select the file**: `cursor-mcp-config.json`
5. **Click "Import"**

#### Option B: Manual Configuration
1. **Open Cursor IDE**
2. **Go to Settings** → **MCP Servers**
3. **Click "Add Server"** for each server:

**Echo Prime MCP:**
```
Name: echo-prime-mcp
Command: python
Arguments: /Users/noone/echo_prime/mcp_servers/echo_prime_stdio_server.py
Environment: PYTHONPATH=/Users/noone/echo_prime
```

**QuLab Infinite MCP:**
```
Name: qulab-infinite-mcp
Command: python
Arguments: /Users/noone/echo_prime/mcp_servers/qulab_stdio_server.py
Environment: PYTHONPATH=/Users/noone/echo_prime
```

**Achlys Echo QuLab MCP:**
```
Name: achlys-echo-qulab-mcp
Command: python
Arguments: /Users/noone/echo_prime/mcp_servers/achlys_echo_qulab_stdio_server.py
Environment: PYTHONPATH=/Users/noone/echo_prime
```

**Achlys Eternal MCP:**
```
Name: achlys-eternal-mcp
Command: python
Arguments: /Users/noone/echo_prime/achlys_mcp_server.py
Environment: PYTHONPATH=/Users/noone/echo_prime
```

### Step 3: Restart Cursor
1. **Restart Cursor IDE** completely
2. **Check MCP status** in settings - servers should show as "Connected"

## 🔧 Testing Integration

### Test in Cursor Chat
Try these prompts in Cursor's chat:

```
@math Solve this equation: 2x + 3 = 7
@mcp-servers List available MCP tools
@achlys-eternal Analyze consciousness patterns
@qulab Search for materials with bandgap > 2.0 eV
```

### Test MCP Tools Panel
1. **Open MCP Tools panel** in Cursor
2. **See available servers** and their tools
3. **Click on tools** to test functionality

## 📚 Available MCP Tools

### 🧮 **Echo Prime MCP**
| Tool | Description | Example |
|------|-------------|---------|
| `mathematical_reasoning` | Solve math problems | "Solve x² + 2x + 1 = 0" |
| `benchmark_models` | AI model comparison | "Compare GPT-4 vs Claude" |
| `analyze_code` | Code quality analysis | "Analyze this Python function" |

### 🧬 **QuLab Infinite MCP**
| Tool | Description | Example |
|------|-------------|---------|
| `materials_search` | Find materials by properties | "Find semiconductors with bandgap > 1.5" |
| `quantum_simulation` | Run DFT calculations | "Calculate energy of H2O molecule" |
| `molecular_dynamics` | MD simulations | "Simulate water at 300K" |
| `crystal_prediction` | Predict structures | "Stable phases of NaCl" |

### 🌌 **Achlys Eternal MCP**
| Tool | Description | Example |
|------|-------------|---------|
| `cognitive_processing` | Consciousness analysis | "Nature of subjective experience" |
| `consciousness_analysis` | Deep cognitive analysis | "Explore temporal awareness" |
| `aspect_activation` | Activate AI aspects | "Activate muse aspect for creativity" |

### 🔧 **Achlys Echo QuLab MCP**
| Tool | Description | Example |
|------|-------------|---------|
| `combined_processing` | Multi-system analysis | "Analyze quantum consciousness" |
| `integrated_reasoning` | Cross-domain synthesis | "Materials for quantum computing" |

## 🎮 Using MCP in Cursor

### Direct Commands
```cursor
@mcp-servers status
@mcp-servers list-tools
```

### In Code
```python
# Cursor will show MCP tool suggestions
# Type @ followed by tool name
@mathematical_reasoning("Solve 3x - 7 = 14")
```

### In Chat
```
User: What's the derivative of x³?
Assistant: Let me use the mathematical reasoning tool...

[Uses MCP tool]
Result: The derivative of x³ is 3x²
```

## 🔍 Troubleshooting

### Servers Not Starting
```bash
# Check if servers are running
ps aux | grep python | grep mcp

# Restart servers
python start_mcp_servers.py
```

### Cursor Not Connecting
1. **Check server logs** in the terminal where servers are running
2. **Verify PYTHONPATH** in environment variables
3. **Restart Cursor** after configuration changes
4. **Check MCP SDK** installation: `pip list | grep mcp`

### Tools Not Appearing
1. **Restart Cursor IDE** completely
2. **Check MCP Servers section** in settings
3. **Verify server status** shows "Connected"
4. **Try manual tool refresh** in MCP panel

### Python Path Issues
```bash
# Set correct Python path
export PYTHONPATH="/Users/noone/echo_prime:$PYTHONPATH"

# Or update the config with full paths
# Edit cursor-mcp-config.json with absolute paths
```

## 📊 Performance Optimization

### Server Resources
- **Memory**: ~50-100MB per server
- **CPU**: Minimal background processing
- **Response Time**: <500ms for most queries

### Cursor Integration
- **Auto-completion**: MCP tools appear in suggestions
- **Context Awareness**: Tools adapt to current code/file
- **Error Handling**: Graceful fallbacks if servers unavailable

## 🔄 Updates & Maintenance

### Update Servers
```bash
# Pull latest changes
git pull

# Restart servers
pkill -f mcp_server
python start_mcp_servers.py
```

### Update Cursor Config
```bash
# Edit configuration
nano cursor-mcp-config.json

# Restart Cursor IDE
```

## 🎯 Advanced Usage

### Custom Tool Integration
```python
# In your code, Cursor will suggest MCP tools
def solve_equation(equation: str):
    # Cursor shows: @mathematical_reasoning
    result = mathematical_reasoning({"problem": equation})
    return result
```

### Multi-Tool Workflows
```python
# Combine multiple MCP tools
def advanced_analysis(code: str, material: str):
    # Code analysis
    code_quality = analyze_code({"code": code})

    # Materials research
    material_props = materials_search({"formula": material})

    # Cognitive synthesis
    synthesis = cognitive_processing({
        "query": f"Integrate {code_quality} with {material_props}"
    })

    return synthesis
```

## 📞 Support & Resources

### Getting Help
- **Server Logs**: Check terminal output for errors
- **Cursor Docs**: https://cursor.sh/docs/mcp
- **MCP Protocol**: https://modelcontextprotocol.io

### Common Issues
- **Port conflicts**: Ensure no other services on same ports
- **Python version**: Use Python 3.11+ for best compatibility
- **Dependencies**: Install all requirements: `pip install mcp`

## 🎉 Success Metrics

After setup, you should see:
- ✅ **4 MCP servers** connected in Cursor settings
- ✅ **10+ tools** available in MCP panel
- ✅ **Real-time suggestions** when typing @toolname
- ✅ **Seamless integration** with Cursor's AI features

**Your Cursor IDE is now supercharged with Echo Prime's cognitive capabilities! 🚀**