repo2graph MCP server

repo2graph

AST-driven code graphs & zero-dependency GraphRAG for AI coding agents and humans

English · 简体中文 · 日本語 · Français · Español · Deutsch

What is it · Quickstart · MCP setup · Benchmarks · Architecture · Docs · Contributing

<!-- mcp-name: io.github.Srinivasan-78/repo2graph -->

⚡ What is repo2graph?

When an AI coding agent searches a codebase with grep or plain keyword matching, it either dumps whole matching files into context — burning the token budget and losing structure — or misses the implementation entirely because it used different words than the search query.

repo2graph parses source with tree-sitter into a graph of real code relationships — CALLS, IMPORTS, INHERITS, DEFINES, COCHANGE — and serves that graph to agents over the Model Context Protocol**, or packs it into a budget-bounded markdown context for any LLM. Every returned block carries an exact [cite: path:start-end] anchor, so answers are traceable back to source instead of paraphrased from a guess.

flowchart LR
    A[your code] --> B[tree-sitter<br/>reads the code]
    B --> C[graph<br/>dots + arrows]
    C --> D[graph.html<br/>the picture]
    C --> E[chunks.jsonl<br/>pieces for an AI]
    C -->|MCP stdio| F[Claude / Cursor /<br/>any MCP client]

No project setup, no language server, no build step — point it at a folder and it works.

graph.html is one self-contained file — no server, no internet, drag to pan, scroll to zoom, click a node to inspect its code and neighbours.

🚀 Quickstart (under 30 seconds)

Requires Python 3.10+. Run via uv, no install step:

Shortened. The full README is on GitHub.