Skip to content
MCP server

gograph

Local call graphs and change-impact analysis of Go repositories for coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
1.7.20
Listing updated
3 days ago

About gograph

gograph is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

gograph parses a Go repository on your machine and stores a structural graph of its packages, symbols, callers and interface implementations. An optional precise mode adds type-checked CHA/SSA enrichment, and builds record whether a result is AST-only, precise, or a visible fallback. It uses no embeddings and no hosted code index.

The same graph is reachable from a CLI and over stdio MCP. Commands such as callers, hotspot, summary, explore, context, plan, review and flow let an agent find a real symbol, trace who calls it, see test attribution and plan a change before editing. Symbol selectors accept forms like path/to/file.go:Receiver.Method when a short name is ambiguous, and results come in bounded pages with snapshot-bound cursors.

Indexing is static analysis only: it does not execute target code or call application services. The project describes itself as complementary to text search and language servers, and says the savings depend on the repository and task. Install it with Homebrew, go install, or the MCPB bundles for macOS and Linux listed in the MCP Registry. The code is MIT licensed.

Install

Run in a terminal

claude mcp add gograph -- npx -y https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gograph": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb"
      ]
    }
  }
}

What it does

Structural Go graph
Builds a local graph of repository symbols, calls and relationships without embeddings.
Precise type-checked mode
Adds CHA/SSA enrichment with build tags support and reports when it falls back.
Caller and implementation tracing
Finds callers and interface implementations with file and line evidence.
Composed workflows
Explore, context, plan and review commands combine related graph evidence into one response.
Change planning
Plans and reviews change impact, including uncommitted edits, with test attribution.
Static and local
Parses source locally and never executes target code.

Good for

  • Trace every caller of a function before refactoring it
  • Find which types implement an interface in a Go codebase
  • Plan the impact of a change before an agent edits files
  • Get a low-token overview of an unfamiliar Go repository
  • Review uncommitted changes against the call graph

Pricing

Open source

MIT licensed; free to install

Prices change. Check gograph.identuum.ai before you buy.

gograph FAQ

Does gograph need an embeddings service or hosted index?

No. It builds a local structural graph and works without embeddings or a hosted code index.

How do I install it?

Use Homebrew (brew install --cask ozgurcd/tap/gograph), go install github.com/ozgurcd/gograph/cmd/gograph@latest, or the MCPB bundles for macOS and Linux.

Does it run my code?

No. Default indexing parses Go source locally and does not execute target code or call application services.

What is the difference between a normal and a precise build?

A normal build is a fast AST graph that tolerates incomplete packages; gograph build . --precise adds type-checked analysis and suits a compilable repository before a major refactor.

Does it replace text search or language servers?

No. The site says text search still suits strings, docs and non-Go files, and language servers give live compiler-backed navigation; gograph adds persisted structure.

Is gograph free?

Yes. gograph is open source, so you can use and self-host it for free.

How do I add gograph to Claude Code?

Run this command in your terminal: claude mcp add gograph -- npx -y https://github.com/ozgurcd/gograph/releases/download/v1.7.20/gograph_1.7.20_darwin_amd64.mcpb

What are the best alternatives to gograph?

The closest alternatives to gograph are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to gograph

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools