Koragraph — Claude Code MCP server: multi-repo code graph
Indexes every repo you point it at into one local graph, so your agent can see what a change will break. Remembers facts tied to the code itself.
claude mcp add koragraph -- npx -y koragraphmcpWhat Koragraph does
Point Koragraph at a set of repositories and it builds a single graph from them: services, files, endpoints, tables, and the calls that actually connect them. Call edges are resolved from the syntax tree instead of guessed by name, and edges that span two repos show up too.
The memory layer stores what your agent learned — fixes for failures, rules, corrections — on your machine, attached to a declaration rather than a line number. Rename the declaration and the note follows it. Delete the declaration and the note retires. No hand-kept CLAUDE.md file is involved.
Setup takes three steps: npm install -g koragraphmcp, then koragraph ingest /path/to/repo, then claude mcp add koragraph -- npx -y koragraphmcp. Node.js 22 or newer is required. One more step gets the memory going: tell your agent in the project to read KORAINIT.md and do what it says. Skip it and only the graph tools work.
You can call the tools over MCP or straight from a shell, for instance koragraph blast src/pay.js. Both routes hit the same graph. Results come back as file:line pointers, and exactly one tool writes to memory.
What it helps with
- check what depends on a file before editing it
- trace callers of a symbol across several repositories
- keep agent notes about bugs and fixes attached to the code they concern
- carry project rules into later sessions without a hand-written context file
- see which symbols tend to change together
Example prompts for the agent
- Set up koragraph for this repo, index it, and report how many nodes and edges you got
- Show me what depends on
src/pay.jsand which parts have no test coverage - Read
KORAINIT.mdand follow it, then tell me what it changed
How to install Koragraph
Platform CLI
claude mcp add koragraph -- npx -y koragraphmcpPlatform CLI
codex mcp add koragraph -- npx -y koragraphmcpConfig file
{
"mcpServers": {
"koragraph": {
"command": "npx",
"args": [
"-y",
"koragraphmcp"
]
}
}
}Config file
{
"servers": {
"koragraph": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"koragraphmcp"
]
}
}
}Platform CLI
gemini mcp add koragraph npx -y koragraphmcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Koragraph
How do I install Koragraph in Claude Code?
Run npm install -g koragraphmcp and then koragraph ingest /path/to/repo to build the graph. Then register the server with claude mcp add koragraph -- npx -y koragraphmcp and run KORAINIT.md once inside the project.
What does Koragraph do?
It turns every repository you give it into one graph with real call edges between files and services, and keeps a memory layer anchored to declarations. When the code behind a note changes, the note follows or retires.
What do I need to run Koragraph?
Node.js 22 or newer. Everything runs locally on your machine. The memory layer needs one setup pass through KORAINIT.md in each project.
