About io.github.n24q02m/better-code-review-graph
io.github.n24q02m/better-code-review-graph is an MCP server in the RAG category: token-efficient code review knowledge graph: semantic search and call-graph resolution.
Install
uvx better-code-review-graphpip install better-code-review-graphThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.n24q02m/better-code-review-graph
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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.
Features
| Feature | code-review-graph | better-code-review-graph |
|---|---|---|
| Multi-word search | Broken (literal substring) | AND-logic word splitting |
| callers_of/callees_of | Empty results (bare name targets) | Qualified name resolution + bare fallback |
| Embedding | sentence-transformers + torch (1.1 GB) | qwen3-embed ONNX + cloud (200 MB), dual-mode |
| Output size | Unbounded (500K+ chars) | Paginated (max_results, truncated flag) |
| Tool design | 9 individual tools | 6 tools: graph + query + review + config + setup + help |
| Plugin hooks | Invalid PostEdit/PostGit | Valid PostToolUse |
Setup
With AI Agent -- copy and send this to your AI agent:
Please set up better-code-review-graph for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-code-review-graph/main/docs/setup-with-agent.md
Manual Setup -- follow docs/setup-manual.md
Tools
graph -- Graph lifecycle
Actions: build | update | stats | embed
| Action | Description |
|---|---|
build |
Full or incremental graph build. Set full_rebuild=true to re-parse all files. |
update |
Alias for build with full_rebuild=false (incremental). |
stats |
Graph size, languages, node/edge breakdown, embedding count. |
embed |
Compute vector embeddings for semantic search. Dual-mode: local ONNX or cloud. |
query -- Graph queries
Actions: query | search | impact | large_functions
| Action | Description |
|---|---|
query |
Predefined pattern queries: callers_of, callees_of, imports_of, importers_of, children_of, tests_for, inheritors_of, file_summary. |
search |
Search code entities by name/keyword or semantic similarity. |
impact |
Blast radius of changed files. Auto-detects from git diff. Paginated with max_results. |
large_functions |
Find functions/classes exceeding a line-count threshold. |
review -- Code review context
Token-optimized review context with structural summary, source snippets, and review guidance. Auto-detects changed files from git diff.
config -- Server configuration
Actions: status | set | cache_clear
| Action | Description |
|---|---|
status |
Server info: version, graph path, node/edge counts, embedding backend. |
set |
Update runtime settings (e.g., log_level). |
cache_clear |
Remove all computed embeddings. |
setup -- Credential setup
Actions: status | start | skip | reset | complete
| Action | Description |
|---|---|
status |
Show current credential state and setup URL. |
start |
Start relay setup to configure API keys via browser. |
skip |
Set local mode (skip relay permanently, use ONNX only). |
reset |
Clear credentials and reset state. |
complete |
Re-resolve credentials from environment variables. |
help -- Full documentation
Topics: graph | query | review | config
Returns complete documentation for each tool. Use when the compressed descriptions above are insufficient.
Security
- Graceful fallbacks -- Cloud embedding failure falls back to local ONNX
- Error handling -- Tools return error strings with fix suggestions, never crash
- Read-only mount -- Docker mode mounts repo as
:ro(read-only)
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
Requirements: Python 3.13, uv
License
MIT -- See LICENSE.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.