cd /path/to/codebase-memory-mcp
podman build -t codebase-memory-mcp .

# Create data directory for persistent indexes
mkdir -p ~/.codebase-memory-data

podman run -i --rm \
  -v "${PWD}:/app/workspace:ro" \
  -v "$HOME/.codebase-memory-data:/app/data" \
  codebase-memory-mcp

{
  "servers": {
    "codebase-memory": {
      "type": "stdio",
      "command": "podman",
      "args": [
        "run", "-i", "--rm",
        "-v", "${workspaceFolder}:/app/workspace:ro",
        "-v", "${env:HOME}/.codebase-memory-data:/app/data",
        "codebase-memory-mcp"
      ]
    }
  }
}

{
  "servers": {
    "codebase-memory": {
      "type": "stdio",
      "command": "podman",
      "args": [
        "run", "-i", "--rm",
        "-v", "${workspaceFolder}:/app/workspace:ro",
        "codebase-memory-mcp"
      ]
    }
  }
}

You: "Index this project"
AI: [calls index_project]
→ ✅ Indexed 150 files in 2.3s
   📊 Total: 1,234 symbols, 567 edges
   📁 Types: function=456, class=78, method=234, ...

You: "Who calls the processOrder function?"
AI: [calls trace_calls(function_name="processOrder", direction="inbound")]
→ Callers of processOrder (depth=3)
   → OrderController.handleOrder (method) - src/controllers/order.ts:45
     → Router.post (function) - src/routes/index.ts:12
   → BatchProcessor.run (method) - src/jobs/batch.ts:89

You: "Give me an overview of this project's architecture"
AI: [calls get_architecture]
→ # 🏗️ Architecture Overview: default
   ## Statistics
   - Files: 45
   - Symbols: 1,234
   - Relationships: 567
   
   ## Hotspots (most called)
   1. validateInput - 23 callers
   2. formatResponse - 18 callers
   ...

You: "Find any potentially unused functions"
AI: [calls find_dead_code]
→ ⚠️ Potentially Dead Code (12 functions with no callers)
   - legacyHandler - src/handlers/old.ts:45
   - deprecatedUtil - src/utils/deprecated.ts:12
   ...

You: "Show me all classes and their method counts"
AI: [calls query_graph]
→ SELECT 
     (SELECT name FROM symbols WHERE id = s.id AND type = 'class') as class_name,
     COUNT(*) as method_count
   FROM symbols s
   WHERE type = 'method'
   GROUP BY parent

{
  "mcpServers": {
    "codebase-memory": {
      "command": "podman",
      "args": [
        "run", "-i", "--rm",
        "-v", "/path/to/your/project:/app/workspace:ro",
        "-v", "/path/to/.codebase-memory-data:/app/data",
        "codebase-memory-mcp"
      ]
    }
  }
}

Inside container:
/app
├── dist/           # Compiled JS
├── node_modules/
├── data/           # SQLite DB (persist via volume mount!)
│   └── memory.db   # Contains: memories, symbols, edges, indexed_files
└── workspace/      # Project code (mounted via -v)
    └── ...

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' \
  | podman run -i --rm codebase-memory-mcp

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' \
  | podman run -i --rm codebase-memory-mcp 2>/dev/null | tail -1 | jq '.result.tools | length'

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' \
  | docker run -i --rm codebase-memory-mcp 2>/dev/null | tail -1 | jq '.result.tools[].name'

"store_memory"
"retrieve_memory"
"list_memories"
"delete_memory"
"search_codebase"
"summarize_file"

Please store a memory with key "test" and content "Hello MCP", then list all memories.

Search for "function" in the codebase.

Summarize the package.json file.

"args": [
  "run", "-i", "--rm",
  "-v", "codebase-memory-data:/app/data",
  "-v", "${workspaceFolder}:/app/workspace:ro",
  "codebase-memory-mcp"
]