better-code-review-graph

mcp-name: io.github.n24q02m/better-code-review-graph

Knowledge graph for token-efficient code reviews -- fixed search, configurable embeddings, qualified call resolution.

Fork of code-review-graph with critical bug fixes, configurable embeddings, and production CI/CD. Parses your codebase with Tree-sitter, builds a structural graph of functions/classes/imports, and gives Claude (or any MCP client) precise context so it reads only what matters.

Why Better

All fixes are submitted upstream as standalone PRs (see Upstream PRs). If all are merged, this repo will be archived.

Installation

Claude Code

claude mcp add better-code-review-graph -- uvx --python 3.13 better-code-review-graph serve

Claude Code Plugin

claude plugin install n24q02m/better-code-review-graph@better-code-review-graph

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "better-code-review-graph": {
      "command": "uvx",
      "args": ["--python", "3.13", "better-code-review-graph", "serve"]
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.better-code-review-graph]
command = "uvx"
args = ["--python", "3.13", "better-code-review-graph", "serve"]

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "better-code-review-graph": {
      "command": "uvx",
      "args": ["--python", "3.13", "better-code-review-graph", "serve"]
    }
  }
}

OpenCode (~/.opencode.json)

{
  "mcpServers": {
    "better-code-review-graph": {
      "command": "uvx",
      "args": ["--python", "3.13", "better-code-review-graph", "serve"]
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "better-code-review-graph": {
      "command": "uvx",
      "args": ["--python", "3.13", "better-code-review-graph", "serve"]
    }
  }
}

Cline (cline_mcp_settings.json)

{
  "mcpServers": {
    "better-code-review-graph": {
      "command": "uvx",
      "args": ["--python", "3.13", "better-code-review-graph", "serve"]
    }
  }
}

Amp (~/.config/amp/settings.json)

{
  "mcpServers": {
    "better-code-review-graph": {
      "command": "uvx",
      "args": ["--python", "3.13", "better-code-review-graph", "serve"]
    }
  }
}

Docker

docker run -i --rm n24q02m/better-code-review-graph

pip

pip install better-code-review-graph
better-code-review-graph serve

Tools

graph -- Knowledge graph operations

Actions: build | update | query | search | impact | review | embed | stats | large_functions

config -- Server configuration

Actions: status | set | cache_clear

help -- Full documentation

Topics: graph | config

Returns complete documentation for each tool. Use when the compressed descriptions above are insufficient.

Embedding Backends

• Auto-detection: API_KEYS or LITELLM_PROXY_URL set -> LiteLLM. Otherwise -> local ONNX.
• Override: EMBEDDING_BACKEND=local or EMBEDDING_BACKEND=litellm.
• Fixed 768-dim storage: Switching backends does NOT invalidate existing vectors.

Configuration

Ignore files

Create .code-review-graphignore in your project root:

generated/**
*.generated.ts
vendor/**
node_modules/**

Supported Languages

Python, TypeScript, JavaScript, Go, Rust, Java, C#, Ruby, Kotlin, Swift, PHP, C/C++

Upstream PRs

All fixes are submitted to code-review-graph:

• #37 -- Multi-word search AND logic
• #38 -- Parser call target resolution (fixes #20)
• #39 -- Impact radius output pagination

If all upstream PRs are merged, this repository will be archived.

Build from Source

git clone https://github.com/n24q02m/better-code-review-graph
cd better-code-review-graph
uv sync --group dev
uv run pytest
uv run better-code-review-graph serve

Requirements: Python 3.13, uv

Compatible With

Also by n24q02m

License

MIT - See LICENSE