# gograph

> gograph is an open-source MCP server for developer tools. Local call graphs and change-impact analysis of Go repositories for coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Website:** https://gograph.identuum.ai
- **Repository:** https://github.com/ozgurcd/gograph
- **MCP Registry name:** io.github.ozgurcd/gograph
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gograph
