codegraph-mcp

Knowledge-Graph MCP Server für GitHub-Repositories. Nimmt den Code jedes GitHub-Repos in einen Neo4j-Graphen auf (Knoten für Repository / Datei / Funktion; Kanten CONTAINS / DEFINES / IMPORTS / CALLS) und stellt diesen Graphen als schreibgeschützte MCP-Tools für jeden MCP-Host bereit – Claude Desktop, opencode, Cursor oder jeden Client, der das Model Context Protocol unterstützt.

Status

v0.1 – stdio-Transport, Neo4j 5.x-Backend, Python ast + tree-sitter (JS/TS/TSX)-Parsing.

Related MCP server: NOMIK

Schnellstart

git clone <codegraph-mcp> && cd codegraph-mcp
uv sync --extra dev              # all deps pinned via uv.lock
docker compose up -d             # Neo4j on bolt://localhost:7687
cp .env.example .env
uv run pytest -m "not slow and not integration"

Ein Repository erfassen

uv run codegraph ingest https://github.com/<owner>/<name>
# → {"graph_id": "owner/name", "files": 142, "functions": 880, ...}

Einen MCP-Host verbinden

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "codegraph": {
      "command": "uv",
      "args": ["run", "--directory", "C:\\path\\to\\codegraph-mcp", "codegraph", "serve"]
    }
  }
}

opencode (in opencode.json)

{
  "mcp": {
    "codegraph": {
      "type": "local",
      "command": ["uv", "run", "--directory", "/path/to/codegraph-mcp", "codegraph", "serve"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "codegraph": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/codegraph-mcp", "codegraph", "serve"]
    }
  }
}

MCP Inspector (zum Testen ohne MCP-Host)

uv run mcp dev src/codegraph/server.py

CLI

Tools

Technologiestack

Python 3.11+, mcp>=1.27,<2 (stabil v1.x FastMCP), Neo4j 5.x, pydantic v2, tree-sitter, GitPython, pytest, ruff, mypy, uv.

Siehe CONTRIBUTING.md für Architektur, Konventionen und Teststrategie.