codegraph — Claude Code MCP server: code graph, 42 tools
Builds a semantic graph of your project and hands it to the agent through 42 tools. Useful when the agent should see how functions connect instead of grepping files.
claude mcp add codegraph -- npx -y @astudioplus/codegraph-mcpWhat codegraph does
CodeGraph parses a repository and assembles a graph: functions, classes, imports, call chains. Parsing runs on tree-sitter and covers 38 languages. The agent gets a structured view of the code instead of reading files one by one.
The server runs as a standard MCP server and indexes the current working directory. Flags cover the common cases: --workspace for several projects, --exclude to skip directories, --max-files with a 5000-file cap, --profile to narrow the exposed tool set. With --graph-only it builds the graph alone, no embeddings, so semantic search and memory tools are unavailable.
The embedding model is set by --embedding-model, bge-small by default. Stored vectors carry the settings that produced them, so a process configured differently ignores them and re-embeds in the background. Leave an old --watch daemon running and sessions attached to it lose semantic search until it restarts.
What it helps with
- find every caller of a function before editing it
- see what a change to a shared module will touch
- give the agent code context without reading dozens of files
- flag missing tests and stale docs on a pull request
- search a TypeScript codebase in plain language
Example prompts for the agent
- Show me every caller of
parseConfigin this project - What breaks if I change the signature of
handleRequest? - Find where the dependency graph gets assembled
How to install codegraph
Platform CLI
claude mcp add codegraph -- npx -y @astudioplus/codegraph-mcpPlatform CLI
codex mcp add codegraph -- npx -y @astudioplus/codegraph-mcpConfig file
{
"mcpServers": {
"codegraph": {
"command": "npx",
"args": [
"-y",
"@astudioplus/codegraph-mcp"
]
}
}
}Config file
{
"servers": {
"codegraph": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astudioplus/codegraph-mcp"
]
}
}
}Platform CLI
gemini mcp add codegraph npx -y @astudioplus/codegraph-mcpStep 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 codegraph
How do I install codegraph in Claude Code?
Run claude mcp add codegraph -- npx -y @astudioplus/codegraph-mcp. The server then indexes the current directory on its own.
What does codegraph do?
It builds a code graph of functions, classes, imports and calls, then exposes it to the agent through 42 tools. The agent sees project structure rather than isolated files.
What do I need for semantic search?
An embedding model, bge-small by default. Under --graph-only no embeddings are built, so semantic search and the memory tools stay off.
