🎯 See It In Action

$ cd my-django-app/
$ code-graph-server &

You → AI:  "Build the code graph for this repo"
AI  →  ✅ Done. 2,341 symbols · 4,892 edges · 127 files indexed (8.3s)

You → AI:  "I changed checkout/views.py and checkout/serializers.py. Review my PR."

AI  →  [review_changes] scanning blast radius...

       📁 Files to review (5 of 127):
          checkout/views.py          ← changed
          checkout/serializers.py    ← changed
          checkout/models.py         ← downstream: CartItem, Order
          payments/stripe.py         ← downstream: charge()
          orders/tasks.py            ← upstream: calls process_checkout()

       ⚡ 2,100 tokens used  (was 18,400 without graph)
       🎯 Quality score: 8.7/10  (was 6.9/10)
       🧮 Optimized with: PageRank + Entropy + LSH + Physics

You → AI:  "What breaks if I rename process_checkout()?"
AI  →  [get_impact] upstream callers: orders/tasks.py, api/webhooks.py
                    downstream callees: payments/stripe.py, cart/models.py

📊 Real-World Results

Repository: Django e-commerce app — 127 Python files
Changed:    checkout/views.py + checkout/serializers.py

┌─────────────────┬──────────────────┬──────────────────┐
│     Metric      │  Without Graph   │   With Graph     │
├─────────────────┼──────────────────┼──────────────────┤
│ Files Read      │      127         │        5         │
│ Tokens Used     │    18,400        │     2,100        │
│ Review Time     │      45s         │       8s         │
│ Quality Score   │    6.9 / 10      │    8.7 / 10      │
│ Cost            │    $0.55         │     $0.06        │
└─────────────────┴──────────────────┴──────────────────┘

        ✅  8.7× fewer tokens   ·   89% cost reduction

✨ Why This Exists

🔬 Mathematical Optimization Engine

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│              AI Assistant                               │
│    Claude · Kimi · Qwen · GPT · Cursor · Windsurf       │
└────────────────────────┬────────────────────────────────┘
                         │  MCP Protocol (JSON-RPC)
                         ▼
┌─────────────────────────────────────────────────────────┐
│              Universal MCP Server                       │
│  build_graph · review_changes · get_impact · find_paths │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│         Mathematical Token Optimizer (6 Techniques)     │
│  Entropy · Spectral · Thermodynamic · Wave · Fractal    │
│                    Renormalization                       │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│              Graph Engine                               │
│         NetworkX + Tree-sitter (AST Parsing)            │
│        Symbols (nodes) · Calls (edges) · Files          │
└────────────────────────┬────────────────────────────────┘
                         │  SQLite
                         ▼
              ┌──────────────────┐
              │  .code_graph.db  │
              │ Persistent Store │
              └──────────────────┘

🚀 Quick Start

Option 1: pip Install

pip install universal-code-review-graph[all]
code-graph-server

Option 2: From Source

git clone https://github.com/cyberNoman/universal-code-review-graph.git
cd universal-code-review-graph/universal-code-graph
pip install -r requirements.txt
python server.py

Option 3: Docker

docker build -t code-graph .
docker run -v $(pwd):/workspace code-graph build /workspace

🔌 Connect Your AI

Claude Code

claude mcp add code-graph code-graph-server

Kimi / Qwen / ChatGPT / Any MCP Client

{
  "mcpServers": {
    "code-graph": {
      "command": "python3",
      "args": ["/path/to/server.py"]
    }
  }
}

Cursor / Windsurf

{
  "servers": {
    "code-graph": {
      "command": "python3",
      "args": ["/path/to/server.py"],
      "type": "stdio"
    }
  }
}

🛠️ The 9 MCP Tools

🌐 Supported AI Assistants

💻 Supported Languages

🧪 CLI Usage

# Build graph for your project
code-graph build /path/to/repo

# Review changed files
code-graph review src/main.py src/utils.py --depth 3

# Search symbols
code-graph search "parse*" --type function

# Show stats
code-graph stats

# Run benchmark
python benchmark.py /path/to/repo

📦 Project Layout

universal-code-review-graph/
├── universal-code-graph/       ← THE PRODUCT
│   ├── server.py               # MCP server entry point
│   ├── code_graph.py           # Graph engine (NetworkX + Tree-sitter)
│   ├── token_optimizer/        # Mathematical optimization (6 techniques)
│   ├── cli.py                  # Command-line interface
│   ├── configs/                # Ready-made configs for every AI
│   └── tests/                  # 94 tests — all passing ✅
│
├── docs/                       # Full documentation
├── app/                        # Landing page (React + Vite)
├── hooks/                      # Pre-commit hooks
├── .github/                    # GitHub Actions CI
├── Dockerfile                  # Docker support
└── docker-compose.yml

🔒 Persistent Across Sessions

👥 Built by Human + AI Collaboration

🤝 Contributing

• Add Rust / Java / C++ — see contributing guide
• Improve token optimization — better algorithms, more techniques
• Bug reports — wrong blast radius results
• Add IDE plugins — JetBrains, Vim, Emacs

📝 License

MIT. See LICENSE.