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

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

# 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

@mcp-servers status
@mcp-servers list-tools

In Code

# 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

# 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

# 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

# Pull latest changes
git pull

# Restart servers
pkill -f mcp_server
python start_mcp_servers.py

Update Cursor Config

# Edit configuration
nano cursor-mcp-config.json

# Restart Cursor IDE

🎯 Advanced Usage

Custom Tool Integration

# 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

# 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! 🚀