Skip to content
MCP server

Repograph

Local MCP server that maps a codebase and traces which files a change affects

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About Repograph

Repograph is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

RepoGraph scans a project's local imports, groups files by directory and by likely architectural layer (entry, business, data, utility), and writes a self-contained interactive HTML map. Clicking a file shows its callers in cyan and its dependencies in red. Directory clustering and utility folding hide heavily shared helpers so the picture does not turn into a tangle.

Three MCP tools expose this to an assistant. One returns the full graph as JSON, one writes the HTML map, and one traces the direct and transitive callers of a file along with the affected clusters and blast radius, which is useful before editing or deleting something. Each call does a fresh static scan and the tools are annotated read-only except the HTML writer.

Scanning stays on your machine, with no account or server. It uses Babel for JavaScript and TypeScript with a regex fallback, and does not execute code, so computed imports and custom aliases can be missed. The README says dead-code warnings are only hints. The CLI also exports JSON, Mermaid and SVG, and runs with npx on Node 18 or newer.

Install

Run in a terminal

claude mcp add repograph -- npx -y repograph-cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "repograph": {
      "command": "npx",
      "args": [
        "-y",
        "repograph-cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "repograph": {
      "command": "npx",
      "args": [
        "-y",
        "repograph-cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "repograph": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "repograph-cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "repograph": {
      "command": "npx",
      "args": [
        "-y",
        "repograph-cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "repograph": {
      "command": "npx",
      "args": [
        "-y",
        "repograph-cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

scan_repository_graph
Scan a repository and return the architecture graph as JSON
generate_architecture_html
Write a self-contained interactive HTML map
query_impact_path
Direct and transitive callers and blast radius for a changed file

What it does

Interactive map
HTML graph with search, minimap and collapsible directory clusters.
Impact tracing
Finds direct and transitive callers and a blast radius for a changed file.
Layer classification
Colours files as entry, business, data, utility or unknown from naming clues.
Utility folding
Hides high fan-in helpers to reduce clutter.
Multiple exports
HTML, JSON, Mermaid and SVG output.
Local scanning
No account or server; code stays on your machine.

Good for

  • Map an unfamiliar codebase before refactoring
  • Check what depends on a file before deleting it
  • Export an architecture diagram in Mermaid for docs
  • Find hub files that many modules rely on

Pricing

Open source

Open source; free via npm

Repograph FAQ

Does it send my code anywhere?

No. Scanning is local, though opening the HTML map loads pinned scripts from public CDNs.

What languages does it parse?

JavaScript and TypeScript through Babel, with a regex fallback for unsupported syntax.

How do I add it to Claude Code?

Run claude mcp add repograph -- npx -y repograph-cli mcp.

Does it run the code?

No. It is a static scan and can miss computed imports and custom aliases.

Is Repograph free?

Yes. Repograph is open source, so you can use and self-host it for free.

How do I add Repograph to Claude Code?

Run this command in your terminal: claude mcp add repograph -- npx -y repograph-cli

What are the best alternatives to Repograph?

The closest alternatives to Repograph are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers