Koragraph

Integration

Koragraph MCP for Claude Code

Four commands, about five minutes, and Claude Code stops reading your repository file by file and starts querying a resolved graph of it. It is free, it runs on your own machine, and no source code is sent anywhere.

Cost

Free

Runs

Locally

Requires

Node.js 22+

Tools added

9

Install

  1. 01

    Install the server

    npm install -g koragraphmcp

    Installs the koragraphmcp package globally, which gives you the koragraph command. Needs Node.js 22 or newer.

  2. 02

    Ingest a repository

    koragraph ingest /path/to/repo

    Parses the repository, resolves the relationships between declarations, mines the git history and writes the graph to a local store under your home directory. Run it once per repository you want the agent to know about. Point it at several and their cross service calls resolve between them into one graph.

  3. 03

    Check the install

    koragraph doctor

    Confirms the server is set up correctly and reports anything that is not. Worth running before you wire it into an agent, so a configuration problem shows up here rather than as an agent that quietly has no tools.

  4. 04

    Add it to Claude Code

    claude mcp add koragraph -s user -- koragraph mcp

    Registers the server with Claude Code at user scope, so it is available in every project rather than only the one you happened to be in. Restart Claude Code afterwards and the nine tools appear.

What Claude Code can do afterwards

The server exposes nine tools. Claude Code picks between them on its own, so you keep asking questions in plain English and the tool calls happen underneath.

ToolWhat it answers
exploreSymbol or plain English. Ranked declarations plus source, callers, callees.
blast_radiusRun before editing. What depends on this, and what has no test coverage.
search_codeLocate a name in the graph, not raw text.
neighboursCallers and callees of one symbol.
changes_withWhat has historically changed together with a symbol.
file_symbolsDeclarations in one file.
overviewOrient on the first turn. Store level index across repos.
recallA failed attempt and its fix, a hazard, a revert.
rememberSave a durable, code anchored fact. The only writer.

Languages it parses

Twelve, through tree-sitter, which is what lets the same extraction behave the same way across all of them: C, C++, C#, Go, Java, JavaScript, PHP, Python, Ruby, Rust, Swift, TypeScript and TSX.

Why bother

Claude Code is already good at reading code. The thing it cannot do on its own is know what it has not read. Without a graph underneath it, answering a question about one function means opening files until the context window fills, and the parts of the answer that live in a repository you did not open never arrive at all.

With the graph, the same question returns a resolved subgraph: the function, its callers, its callees, the tests that cover it, and the calls that cross out of the repository into another service. We publish the measurements behind that claim on the benchmarks page, including the ones where the other system wins.

Koragraph MCP

Get it from GitHub.

One live graph of every repository you point it at, served over the Model Context Protocol, so the agent you already use reads your systems instead of rediscovering them.

Download on GitHub

Completely free, and it runs locally · github.com/Koragraph/KoragraphMCP