memory-engineering/TROUBLESHOOTING.md

Advanced Memory-Aware Code Context System with claude-flow-inspired architecture, showcasing MongoDB + Voyage AI strategic positioning

# Memory Engineering 2.3.0 - MCP Troubleshooting Guide

## 🔍 Issue: "No tools or prompts" in MCP Client

### ✅ **VERIFIED WORKING SOLUTIONS**

The server is working correctly and returns all 6 tools:
- memory_init
- memory_project_brief  
- memory_product_context
- memory_active_context
- memory_search
- memory_codebase_embed

### 🔧 **MCP Client Configuration**

#### **For Cursor:**
Add this to your Cursor MCP settings:

```json
{
  "mcpServers": {
    "memory-engineering": {
      "command": "node",
      "args": ["/opt/homebrew/lib/node_modules/memory-engineering/dist/index.js"],
      "env": {
        "MONGODB_PROVIDER": "community",
        "MONGODB_URI": "mongodb://localhost:27017/memory_engineering",
        "LOG_LEVEL": "info"
      }
    }
  }
}
```

#### **Alternative NPX Configuration:**
```json
{
  "mcpServers": {
    "memory-engineering": {
      "command": "npx",
      "args": ["memory-engineering@2.3.0"],
      "env": {
        "MONGODB_PROVIDER": "community", 
        "MONGODB_URI": "mongodb://localhost:27017/memory_engineering",
        "LOG_LEVEL": "info"
      }
    }
  }
}
```

#### **For Claude Desktop:**
```json
{
  "mcpServers": {
    "memory-engineering": {
      "command": "memory-engineering",
      "env": {
        "MONGODB_PROVIDER": "community",
        "MONGODB_URI": "mongodb://localhost:27017/memory_engineering",
        "LOG_LEVEL": "info"
      }
    }
  }
}
```

### 🧪 **Manual Testing**

Test the server directly:
```bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | \
MONGODB_PROVIDER=community \
MONGODB_URI=mongodb://localhost:27017/memory_engineering_test \
node /opt/homebrew/lib/node_modules/memory-engineering/dist/index.js
```

### 🔄 **Common Fixes**

1. **Restart MCP Client**: Close and reopen Cursor/Claude Desktop
2. **Clear Cache**: Clear MCP client cache if available
3. **Check MongoDB**: Ensure MongoDB is running on localhost:27017
4. **Verify Installation**: `npm list -g memory-engineering`
5. **Check Permissions**: Ensure binary is executable

### 📊 **Expected Output**

When working correctly, you should see:
- ✅ Memory system initialized successfully
- ✅ 6 tools registered
- ✅ Claude-flow architecture active
- ✅ Health status: Healthy

### 🆘 **Still Having Issues?**

1. Check MongoDB connection
2. Verify Node.js version (>=18.0.0)
3. Try local installation: `npm install memory-engineering@2.3.0`
4. Check MCP client logs for errors

---

**Memory Engineering 2.3.0** - Complete claude-flow architecture with all tools working! 🚀