codegraph-mcp

Servidor MCP de Grafo de Conocimiento para repositorios de GitHub. Ingiere el código de cualquier repositorio de GitHub en un grafo de Neo4j (nodos: Repositorio / Archivo / Función; aristas: CONTAINS / DEFINES / IMPORTS / CALLS) y expone dicho grafo como herramientas MCP de solo lectura a cualquier host MCP: Claude Desktop, opencode, Cursor o cualquier cliente que hable el Model Context Protocol.

Estado

v0.1 — transporte stdio, backend Neo4j 5.x, análisis con ast de Python + tree-sitter (JS/TS/TSX).

Related MCP server: NOMIK

Inicio rápido

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"

Ingresar un repositorio

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

Conectar un host MCP

Claude Desktop (claude_desktop_config.json)

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

opencode (en 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 (para pruebas sin un host MCP)

uv run mcp dev src/codegraph/server.py

CLI

Herramientas

Stack tecnológico

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

Consulta CONTRIBUTING.md para la arquitectura, convenciones y estrategia de pruebas.