codegraph-mcp

MCP-сервер графа знаний для репозиториев GitHub. Загружает код любого репозитория GitHub в граф Neo4j (узлы Repository / File / Function; ребра CONTAINS / DEFINES / IMPORTS / CALLS) и предоставляет этот граф в виде read-only MCP-инструментов любому MCP-хосту — Claude Desktop, opencode, Cursor или любому клиенту, поддерживающему Model Context Protocol.

Статус

v0.1 — транспорт stdio, backend Neo4j 5.x, парсинг с помощью Python ast + tree-sitter (JS/TS/TSX).

Related MCP server: NOMIK

Быстрый старт

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"

Загрузка репозитория

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

Подключение MCP-хоста

Claude Desktop (claude_desktop_config.json)

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

opencode (в 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 (для тестирования без MCP-хоста)

uv run mcp dev src/codegraph/server.py

CLI

Инструменты

Технический стек

Python 3.11+, mcp>=1.27,<2 (стабильный v1.x FastMCP), Neo4j 5.x, pydantic v2, tree-sitter, GitPython, pytest, ruff, mypy, uv.

См. CONTRIBUTING.md для архитектуры, соглашений и стратегии тестирования.