Skip to main content
Glama
forsling

codegraph-mcp

by forsling

codegraph-mcp

Graph-native code intelligence for coding agents.

This project tests a simple hypothesis: an agent should navigate a repository through a compact, deterministic program graph and retrieve full source only for symbols it decides are relevant.

The MVP indexes TypeScript into a function/symbol-level SQLite graph and exposes structural queries over MCP.

Current MVP

  • TypeScript Compiler API indexing

  • stable symbol IDs

  • function/method call edges

  • symbol read/write/reference edges

  • SQLite graph store

  • compact MCP queries

  • lazy source retrieval by symbol

Related MCP server: codebase-rag

Try it

npm install
npm run build
node dist/cli.js index /path/to/typescript/project
node dist/cli.js serve /path/to/typescript/project

The server uses stdio transport, so an MCP host should launch the serve command and communicate over stdin/stdout.

The index database defaults to <project>/.codegraph.sqlite. Pass a third argument to index and serve to use another path.

MCP tools

search_symbols, get_symbol, get_neighbors, get_callers, get_callees, get_references, and get_source.

See docs/DESIGN.md for the experiment and docs/MCP.md for the tool contract.

Status

Early MVP foundation. Direct-edge correctness, path traversal, stale-index detection, fixtures, and the evaluation harness are next.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    A local code-intelligence engine for AI agents that indexes repositories into a PostgreSQL-backed code graph and serves structured, token-budgeted context over MCP and HTTP, enabling targeted queries on symbols, dependencies, contracts, and impact analysis.
    3
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.
    3
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Provides persistent codebase memory and semantic context for AI agents via AST-aware chunking and symbol graph indexing.
    1
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides AI agents with causal code memory by indexing repositories into a graph of symbols and edges, enabling context-aware retrieval of relevant code slices.
    23 PyPI
    3
    MIT