Lord1Egypt SocratiCode MCP
Install and configure SocratiCode for semantic code search and codebase intelligence on OpenClaw.
What is SocratiCode?
MCP server providing:
- Hybrid search - Semantic + keyword search via RRF
- Code indexing - AST-aware chunking at function/class boundaries
- Dependency graphs - Import analysis for 18+ languages
- Live updates - File watcher keeps index current
Prerequisites
| Requirement | Purpose |
|---|---|
| Docker running | Qdrant vector database |
| npx (Node.js 18+) | Execute socraticode package |
| mcporter | Manage MCP servers |
Installation
Step 1: Install mcporter
npm install -g mcporter
Step 2: Configure mcporter
Create ~/.openclaw/workspace/config/mcporter.json:
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": ["-y", "socraticode"]
}
}
}
Verify:
mcporter list
Step 3: Start Qdrant
docker run -d --name socraticode-qdrant \
-p 16333:6333 -p 16334:6334 \
qdrant/qdrant:v1.17.0
Per-Project Indexing
To index a specific project (not the config directory), create mcporter.json in project root:
cd /path/to/your-project
echo '{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": ["-y", "socraticode"]
}
}
}' > mcporter.json
Then use --config mcporter.json:
# Index
mcporter --config mcporter.json call socraticode.codebase_index
# Check status
mcporter --config mcporter.json call socraticode.codebase_status
# Search
mcporter --config mcporter.json call socraticode.codebase_search query="auth" limit=5
Commands
| Command | Purpose |
|---|---|
codebase_index |
Start indexing |
codebase_status |
Check progress |
codebase_search |
Semantic search |
codebase_graph_query |
Find imports/dependents |
codebase_graph_visualize |
Mermaid diagram |
codebase_graph_circular |
Detect cycles |
codebase_watch |
Toggle file watcher |
codebase_stop |
Stop indexing |
Troubleshooting
Indexing Wrong Directory
Use per-project mcporter.json + --config flag.
Qdrant Not Running
docker start socraticode-qdrant
# Or recreate:
docker run -d --name socraticode-qdrant -p 16333:6333 -p 16334:6334 qdrant/qdrant:v1.17.0
Slow on macOS/Windows
Install native Ollama:
brew install ollama
ollama serve
Or use OpenAI:
export OPENAI_API_KEY=your-key
export EMBEDDING_PROVIDER=openai
Agent Integration
Add to your AGENTS.md:
## Codebase Search (SocratiCode)
- Use `codebase_search` for exploration
- Check `codebase_status` if no results
- Search before reading files