Repo Graph MCP Server

repo-graph gives LLMs a map of your codebase — entities, relationships, and flows — so they can navigate to the right files without reading

Local serverstdioPython

What is the Repo Graph MCP server?

Repo Graph MCP server exists for a simple reason — assistants are far more useful when they can act on Repo Graph directly instead of describing what you should do. repo-graph gives LLMs a map of your codebase — entities, relationships, and flows — so they can navigate to the right files without reading everything first.

What the assistant can call

Once Repo Graph is connected, these are the calls the assistant has available:

  • orient — seed (optional), full, budget
  • find — query, expand, kind, top_k, budget
  • impact — nodes (comma-separated), direction, depth, live_only, top_k, budget
  • trace — from_node, to_node (optional), depth, budget
  • read — node (comma-separated), context_lines, budget
  • refresh — repo_path (optional), full

Setting it up

mcp-repo-graph on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Repo Graph's toolset — orient, find, impact and 3 more — is a fair guide to whether it matches your workflow. It is maintained by james-chahwan; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the repo graph mcp server does with a few real requests.

Available tools

ToolWhat it does
orientseed *(optional)*, full, budget
findquery, expand, kind, top_k, budget
impactnodes *(comma-separated)*, direction, depth, live_only, top_k, budget
tracefrom_node, to_node *(optional)*, depth, budget
readnode *(comma-separated)*, context_lines, budget
refreshrepo_path *(optional)*, full

How to install the Repo Graph MCP server

{
  "mcpServers": {
    "repo-graph": {
      "command": "uvx",
      "args": ["mcp-repo-graph"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Repo Graph to orient.
  • Use Repo Graph to find.
  • Use Repo Graph to impact.

Frequently asked questions

It connects Repo Graph to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (orient, find, impact, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Repo Graph directly.