codegraph-ai avatar

Codegraph

codegraph-ai/codegraph

Turns your codebase into a queryable semantic graph across 38 languages and exposes it through 42 MCP tools. Ask for callers, callees, impact analysis, circular dependencies, or AI-curated context for a specific task (explain, modify, debug, test). It runs locally via tree-sitter, includes a persistent memory layer for cross-session notes, and ships with a VS Code extension plus GitHub Action for PR reviews. The `--graph-only` flag skips embeddings for fast CI runs. Includes agent rule files that teach Claude, Cursor, and Windsurf to query the graph before falling back to grep. Useful when you need structured code intelligence instead of full-text search, especially for refactoring, onboarding, or understanding call chains in large polyglot repos.

GitHub stars
144
tools
42
transport
STDIO
last updated
Oct 6, 2026

Tools

42 tools

Public tool metadata for what this MCP can expose to an agent.

get_ai_contextPrimary context tool. Intent-aware (explain/modify/debug/test) with token budgeting. Returns source, related symbols, imports, siblings, debug hints.

Primary context tool. Intent-aware (explain/modify/debug/test) with token budgeting. Returns source, related symbols, imports, siblings, debug hints.

No parameter schema in public metadata yet.

get_edit_contextEverything needed before editing: source + callers + tests + memories + git history

Everything needed before editing: source + callers + tests + memories + git history

No parameter schema in public metadata yet.

get_curated_contextCross-codebase context for a natural language query ("how does auth work?")

Cross-codebase context for a natural language query ("how does auth work?")

No parameter schema in public metadata yet.

analyze_impactBlast radius prediction — what breaks if you modify, delete, or rename

Blast radius prediction — what breaks if you modify, delete, or rename

No parameter schema in public metadata yet.

analyze_complexityCyclomatic complexity with breakdown (branches, loops, nesting, exceptions, early returns)

Cyclomatic complexity with breakdown (branches, loops, nesting, exceptions, early returns)

No parameter schema in public metadata yet.

find_circular_depsDetect circular import/dependency chains across files

Detect circular import/dependency chains across files

No parameter schema in public metadata yet.

find_hot_pathsMost-called functions ranked by transitive caller count

Most-called functions ranked by transitive caller count

No parameter schema in public metadata yet.

find_dead_importsFind unused imports — modules imported but never referenced

Find unused imports — modules imported but never referenced

No parameter schema in public metadata yet.

get_module_summaryHigh-level summary of a directory: file count, functions, language breakdown, top complex functions

High-level summary of a directory: file count, functions, language breakdown, top complex functions

No parameter schema in public metadata yet.

search_by_patternRegex search across function bodies, signatures, names, and docstrings

Regex search across function bodies, signatures, names, and docstrings

No parameter schema in public metadata yet.

search_by_errorFind functions that throw, catch, or handle specific error types

Find functions that throw, catch, or handle specific error types

No parameter schema in public metadata yet.

symbol_searchFind symbols by name or natural language (hybrid BM25 + semantic search)

Find symbols by name or natural language (hybrid BM25 + semantic search)

No parameter schema in public metadata yet.

get_callersWho calls this? (with transitive depth)

Who calls this? (with transitive depth)

No parameter schema in public metadata yet.

get_calleesWhat does it call? (with transitive depth)

What does it call? (with transitive depth)

No parameter schema in public metadata yet.

get_detailed_symbolFull symbol info: source, callers, callees, complexity

Full symbol info: source, callers, callees, complexity

No parameter schema in public metadata yet.

get_symbol_infoQuick metadata: signature, visibility, kind

Quick metadata: signature, visibility, kind

No parameter schema in public metadata yet.

get_dependency_graphFile/module import relationships with depth control

File/module import relationships with depth control

No parameter schema in public metadata yet.

get_call_graphFunction call chains (callers and callees)

Function call chains (callers and callees)

No parameter schema in public metadata yet.

find_by_importsFind files importing a module

Find files importing a module

No parameter schema in public metadata yet.

find_by_signatureSearch by param count, return type, modifiers

Search by param count, return type, modifiers

No parameter schema in public metadata yet.

find_entry_pointsMain functions, HTTP handlers, CLI commands, event handlers

Main functions, HTTP handlers, CLI commands, event handlers

No parameter schema in public metadata yet.

find_implementorsFind all functions registered as ops struct callbacks

Find all functions registered as ops struct callbacks

No parameter schema in public metadata yet.

find_related_testsTests that exercise a given function

Tests that exercise a given function

No parameter schema in public metadata yet.

traverse_graphCustom graph traversal with edge/node type filters

Custom graph traversal with edge/node type filters

No parameter schema in public metadata yet.

reindex_workspaceFull or incremental workspace reindex

Full or incremental workspace reindex

No parameter schema in public metadata yet.

index_filesAdd/update specific files without full reindex

Add/update specific files without full reindex

No parameter schema in public metadata yet.

index_directoryAdd directory to graph alongside existing data

Add directory to graph alongside existing data

No parameter schema in public metadata yet.

memory_storeStore memories (BM25 + semantic)

Store memories (BM25 + semantic)

No parameter schema in public metadata yet.

memory_getRetrieve memories

Retrieve memories

No parameter schema in public metadata yet.

memory_searchSearch memories (BM25 + semantic)

Search memories (BM25 + semantic)

No parameter schema in public metadata yet.

memory_contextGet memories relevant to a file/function

Get memories relevant to a file/function

No parameter schema in public metadata yet.

memory_listBrowse memories

Browse memories

No parameter schema in public metadata yet.

memory_invalidateRetire memories

Retire memories

No parameter schema in public metadata yet.

memory_statsMonitor memories

Monitor memories

No parameter schema in public metadata yet.

pr_contextOne-call PR review: blast radius, test coverage and gaps, affected modules, change classification, stale-doc warnings, complexity, commit-message hint, suggested reviewers

One-call PR review: blast radius, test coverage and gaps, affected modules, change classification, stale-doc warnings, complexity, commit-message hint, suggested reviewers

No parameter schema in public metadata yet.

index_markdownIndex a local .md file into the persistent docs store with heading-tree chunking and leaf-node embeddings

Index a local .md file into the persistent docs store with heading-tree chunking and leaf-node embeddings

No parameter schema in public metadata yet.

search_docsSemantic search over indexed docs, returning matching sections with heading-path breadcrumbs

Semantic search over indexed docs, returning matching sections with heading-path breadcrumbs

No parameter schema in public metadata yet.

list_doc_sourcesList all indexed source files

List all indexed source files

No parameter schema in public metadata yet.

remove_doc_sourceRemove all indexed chunks from a source file

Remove all indexed chunks from a source file

No parameter schema in public metadata yet.

verify_designCross-reference doc claims vs code graph (forward, reverse, or both)

Cross-reference doc claims vs code graph (forward, reverse, or both)

No parameter schema in public metadata yet.

design_gapsFind identifiers described in docs that don't exist in code yet

Find identifiers described in docs that don't exist in code yet

No parameter schema in public metadata yet.

generate_architecture_docAuto-generate a structured ARCHITECTURE.md from the live code graph

Auto-generate a structured ARCHITECTURE.md from the live code graph

No parameter schema in public metadata yet.

Sponsors

Readme

CodeGraph

Cross-language code intelligence for AI agents and developers.

License

CodeGraph builds a semantic graph of your codebase — functions, classes, imports, call chains — and exposes it through 42 MCP tools, a VS Code extension, a JetBrains IDE plugin, and a persistent memory layer. Parses 38 languages via tree-sitter. AI agents get structured code understanding instead of grepping through files.

Quick Start

MCP Server (Claude Code, Cursor, any MCP client)

Add to ~/.claude.json (or your MCP client config):

{
  "mcpServers": {
    "codegraph": {
      "command": "/path/to/codegraph-server",
      "args": ["--mcp"]
    }
  }
}

The server indexes the current working directory automatically.

VS Code Extension

Install the VSIX:

code --install-extension codegraph-0.21.0.vsix

View the full README on GitHub

Details

Repository
github.com/codegraph-ai/codegraph
Category
AI & LLM Tools
Package
@astudioplus/codegraph-mcp
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1jnmetacode avatarShellwardjnmetacode/shellwardAI agent security: 7 MCP tools for injection detection, PII scanning, command safety, DLP.108stars
2frumu-ai avatarDocs Mcpfrumu-ai/tandemRemote MCP server for Tandem docs, install guides, SDKs, workflows, and agent setup help.107stars
3major7apps avatarPensyvemajor7apps/pensyveUniversal memory runtime for AI agents — episodic, semantic, and procedural memory.99stars
4vortx-ai avataremem, the verifiable memory protocol for the physical worldvortx-ai/ememShared, verifiable memory for machines and AI. Encode where data lives; decode with any AI.89stars
5sverklo avatarSverklosverklo/sverkloLocal-first MCP code intelligence: 37 tools — hybrid search, blast-radius, diff review, memory.71stars
6xelektron avatarToken Enhancerxelektron/token-enhancerCuts AI web-fetching costs up to 99.9% by stripping page junk before it reaches your LLM.66stars