GithubMCP

Производственный MCP-сервер персонального помощника разработчика

Бесшовно подключайте ИИ-модели (Claude, Cursor и др.) к вашим рабочим процессам GitHub, CI/CD-пайплайнам, контексту локального рабочего пространства и инструментам анализа кода.

Обзор

GithubMCP — это MCP-сервер (Model Context Protocol), созданный для разработчиков. Он напрямую связывает ИИ-ассистентов с вашей средой разработки и позволяет им:

• Исследовать репозитории GitHub, пул-реквесты, issue, коммиты и код в публичных и приватных репозиториях.

• Управлять конфиденциальностью и видимостью репозиториев (public/private) прямо через диалог.

• Отслеживать запуски CI/CD-пайплайнов и разбирать упавшие шаги сборки в GitHub Actions.

• Безопасно просматривать локальную файловую систему в пределах заданных пользователем разрешённых путей.

• Анализировать качество кода, рассчитывать метрики сложности, находить TODO и обнаруживать потенциально опасные места с секретами.

Поддерживаются оба режима транспорта: STDIO (Claude Desktop, Cursor) и SSE (Server-Sent Events, для веб-клиентов).

Related MCP server: GitHub MCP Server

Справочник инструментов

GithubMCP предоставляет 13 специализированных инструментов:

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

1. Предварительные требования

• Python 3.11+

• uv (быстрый менеджер пакетов Python)

Установите uv (если ещё не установлен):

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

2. Клонирование и настройка

git clone https://github.com/Dhananjayrbiraris/github-mcp.git
cd github-mcp

# Install dependencies and sync virtual environment
uv sync

3. Конфигурация окружения

Скопируйте файл-шаблон .env.example в .env:

cp .env.example .env

Отредактируйте .env, указав личный токен доступа GitHub (Personal Access Token):

# GitHub Personal Access Token (Classic PAT with 'repo', 'workflow', 'read:user' scopes)
GITHUB_TOKEN=ghp_your_github_token_here

# Default GitHub Username (Optional)
GITHUB_USERNAME=your_username

# Sandboxed directories allowed for local filesystem operations
ALLOWED_PATHS=["~/projects", "~/workspace", "."]

# Max file size limit in MB for reading files
MAX_FILE_SIZE_MB=10

# Default Transport mode: "stdio" or "sse"
TRANSPORT=stdio

Генерация GitHub-токена: Перейдите в GitHub Settings -> Developer Settings -> Personal access tokens (classic) и создайте токен с правами repo, workflow и read:user.

Руководства по настройке клиентов

A. Claude Desktop

1. Откройте файл конфигурации Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

2. Добавьте сервер github-mcp:

{
  "mcpServers": {
    "github-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/github-mcp",
        "run",
        "python",
        "-m",
        "github_mcp.main",
        "--transport",
        "stdio"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_personal_access_token_here"
      }
    }
  }
}

(В Windows используйте обратную косую черту, например C:\\Users\\yourname\\path\\to\\github-mcp, либо прямую).

3. Перезапустите Claude Desktop

Откройте Claude Desktop — нажмите иконку Tools (Инструменты) в правом нижнем углу поля ввода, чтобы увидеть все подключённые инструменты GithubMCP.

B. Cursor IDE

В Cursor:

1. Перейдите в Cursor Settings -> Features -> MCP.

2. Нажмите + Add New MCP Server.

3. Заполните:

   • Name: github-mcp

   • Type: command

   • Command: uv --directory /path/to/github-mcp run python -m github_mcp.main --transport stdio

C. Server-Sent Events (SSE) / веб-клиенты

Чтобы запустить MCP-сервер через HTTP / Server-Sent Events:

uv run python -m github_mcp.main --transport sse --host 0.0.0.0 --port 8000

SSE-эндпоинтбудет доступен по адресу: http://localhost:8000/sse

Безопасность и песочница

1. Ограничение путей: файловые инструменты (read_file, list_directory, search_local_files, get_project_context) строго проверяют пути на допустимость относительно ALLOWED_PATHS. Дата обращений до минимум вне разрешённого списка вызовет исключение SecurityError.

2. Управление секретами: токены и учётные данные никогда не логируются и не раскрываются.

3. Устойчивость к ограничениям: при тротлинге лимитов GitHub API автоматически выполняются повторные попытки с экспоненциальной задержкой.

Разработка и тестирование

Запустите полный набор тестов и проверки качества:

# Run pytest unit tests
uv run pytest

# Run linter
uv run ruff check .

# Check code formatting
uv run ruff format --check .

# Run strict type checking
uv run mypy src/

Структура репозитория

github-mcp/
├── .github/workflows/ci.yml # GitHub Actions CI workflow
├── src/github_mcp/
│   ├── __init__.py
│   ├── main.py              # Server entrypoint & MCP tool registrations
│   ├── config.py            # Pydantic Settings model
│   ├── github_tools.py      # GitHub API integrations & visibility controls
│   ├── file_tools.py        # Sandboxed local filesystem operations
│   ├── ci_tools.py          # GitHub Actions CI/CD monitoring
│   ├── analysis_tools.py    # Diff categorization & code quality analyzer
│   └── utils.py             # Path safety, error handling, rate limiting
├── tests/
│   ├── conftest.py          # Pytest fixtures and mocks
│   ├── test_github.py       # GitHub tools unit tests
│   ├── test_files.py        # Filesystem tools unit tests
│   └── test_ci.py           # CI status tools unit tests
├── docs/
│   ├── architecture.md      # System architecture & data flow
│   └── tools_reference.md   # Complete API schemas for all 13 tools
├── pyproject.toml           # Project dependencies & tool configurations
├── .env.example             # Environment variable template
├── CONTRIBUTING.md          # Open-source contribution guidelines
├── SECURITY.md              # Security policy & vulnerability reporting
└── LICENSE                  # MIT License

Лицензия

Этот проект по лицензии MIT License — бесплатно для личного и коммерческого использования.