code-review-graph

Install

npx skillfoxx add mcp/code-review-graph

claude mcp add --transport stdio code-review-graph -- uvx code-review-graph serve

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

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

code --add-mcp '{"name":"code-review-graph","type":"stdio","command":"uvx","args":["code-review-graph","serve"]}'

{
  "servers": {
    "code-review-graph": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "code-review-graph",
        "serve"
      ]
    }
  }
}

codex mcp add code-review-graph -- uvx code-review-graph serve

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

gemini mcp add -s user code-review-graph uvx code-review-graph serve

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

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

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

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

{
  "mcp": {
    "code-review-graph": {
      "type": "local",
      "command": [
        "uvx",
        "code-review-graph",
        "serve"
      ]
    }
  }
}

{
  "context_servers": {
    "code-review-graph": {
      "command": "uvx",
      "args": [
        "code-review-graph",
        "serve"
      ]
    }
  }
}

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

pip install code-review-graph
code-review-graph install
code-review-graph build

This is third-party code. Review the repository files before installing.

What it does

The tool parses source code with tree-sitter and builds a persistent graph of relations: functions, classes, calls, dependencies. The graph lives locally in the project and updates incrementally through hooks and a watch mode, so it does not need a full rebuild after every commit. Over MCP the assistant asks the graph for compact context around a change instead of re-reading large parts of the codebase. It installs as a package from PyPI, and the install command detects your editors and agents and wires up the MCP server, hooks and rules for each. It ships token-savings benchmarks, a CLI mode and a GitHub Action for review inside a pipeline.

Who it is for. For developers and reviewers who want the assistant to read only the relevant files during review and work in a large repository.

Example request

Build the code review graph for this project and show what my change affects

Limitations

Requires Python 3.10 or newer. The first build takes time and scales with repository size, some files may fail to parse and then the build is marked partial. The structural graph runs locally without external keys. Semantic search over embeddings is a separate option that needs an embedding provider key or a local gateway such as Ollama in OpenAI mode.

How to disable. Run code-review-graph uninstall in the repository root; it removes its own files and MCP entries and leaves other servers and hooks alone. The --dry-run flag previews changes without applying them.

MCP

Transport

stdio

Authentication

not required

Security check

• Reads the project source and builds a local database from it
• Installs hooks and edits agent configuration during setup

README in short

The README explains that assistants often re-read large parts of code for a single change, and offers a tree-sitter structure graph that serves compact context over MCP instead. The quick start has three steps: install from PyPI, run install to auto-configure editors, and build to parse the code. The uninstall command removes the integration cleanly and leaves other settings untouched. It also documents embedding providers for semantic search, reproducible token-savings benchmarks and a GitHub Action. MIT licensed, needs Python 3.10 or newer.

Related