GitHub MCP Server

GitHub MCP Server подключает AI-инструменты напрямую к платформе GitHub. Это даёт AI-агентам, ассистентам и чат-ботам возможность читать репозитории и файлы с кодом, управлять issues и PR, анализировать код и автоматизировать рабочие процессы — всё через взаимодействие на естественном языке.

Сценарии использования

• Управление репозиториями: просмотр и запросы к коду, поиск файлов, анализ коммитов и понимание структуры проекта в любом доступном репозитории.
• Автоматизация issues и PR: создание, обновление и управление issues и pull request'ами. AI помогает с триажем багов, ревью изменений кода и ведением досок проекта.
• CI/CD и аналитика рабочих процессов: мониторинг запусков GitHub Actions, анализ сбоев сборки, управление релизами и получение аналитики по пайплайну разработки.
• Анализ кода: изучение результатов проверок безопасности, просмотр алертов Dependabot, понимание паттернов кода и получение комплексной аналитики по кодовой базе.
• Командная работа: доступ к обсуждениям, управление уведомлениями, анализ активности команды и оптимизация процессов.

Создан для разработчиков, которые хотят подключить свои AI-инструменты к контексту и возможностям GitHub — от простых запросов на естественном языке до сложных многошаговых агентных рабочих процессов.

Удалённый GitHub MCP Server

Удалённый GitHub MCP Server размещается на стороне GitHub и предоставляет наиболее простой способ начать работу. Если ваш MCP-хост не поддерживает удалённые MCP-серверы — не беспокойтесь! Вместо него можно использовать локальную версию GitHub MCP Server.

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

1. Совместимый MCP-хост с поддержкой удалённых серверов (VS Code 1.101+, Claude Desktop, Cursor, Windsurf и др.)
2. Включённые необходимые политики

Установка в VS Code

Для быстрой установки используйте одну из кнопок установки в один клик выше. После завершения процесса включите режим Agent (расположен рядом с полем ввода Copilot Chat), и сервер запустится. Убедитесь, что используете VS Code 1.101 или более новую версию для поддержки удалённого MCP и OAuth.

Как вариант, для ручной настройки VS Code выберите подходящий JSON-блок из примеров ниже и добавьте его в конфигурацию хоста:

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:github_mcp_pat}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "github_mcp_pat",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

Установка в других MCP-хостах

• Copilot CLI — руководство по установке для GitHub Copilot CLI
• GitHub Copilot в других IDE — установка для JetBrains, Visual Studio, Eclipse и Xcode с GitHub Copilot
• Приложения Claude — руководство по установке для Claude Desktop и Claude Code CLI
• Codex — руководство по установке для OpenAI Codex
• Cursor — руководство по установке для Cursor IDE
• Windsurf — руководство по установке для Windsurf IDE
• Rovo Dev CLI — руководство по установке для Rovo Dev CLI

Примечание: Каждому MCP-хост-приложению необходимо настроить GitHub App или OAuth App для поддержки удалённого доступа через OAuth. Любое хост-приложение с поддержкой удалённых MCP-серверов должно поддерживать удалённый GitHub-сервер с PAT-аутентификацией. Детали конфигурации и уровни поддержки варьируются в зависимости от хоста. Обязательно обращайтесь к документации хост-приложения для получения дополнительной информации.

Конфигурация

Настройка наборов инструментов

См. документацию по удалённому серверу для получения полной информации о конфигурации удалённого сервера, наборах инструментов, заголовках и расширенном использовании. Этот файл содержит исчерпывающие инструкции и примеры подключения, настройки и установки удалённого GitHub MCP Server в VS Code и других MCP-хостах.

Если наборы инструментов не указаны, используются наборы по умолчанию.

Режим Insiders

Попробуйте новые функции раньше других! Удалённый сервер предлагает версию insiders с ранним доступом к новым возможностям и экспериментальным инструментам.

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/insiders"
    }
  }
}

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "X-GitHub-MCP-Insiders": "true"
      }
    }
  }
}

Локальный GitHub MCP Server

Локальный GitHub MCP Server запускается на вашем компьютере и подключается к GitHub через персональный токен доступа (PAT).

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

1. Совместимый MCP-хост (Claude Desktop, VS Code, Cursor, Windsurf и др.)
2. Персональный токен доступа GitHub (PAT) с необходимыми разрешениями

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

Локальный сервер можно запустить несколькими способами:

Через Docker

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<ваш-токен> \
  ghcr.io/github/github-mcp-server

Через скомпилированный бинарный файл

Скачайте последний релиз со страницы релизов и запустите:

export GITHUB_PERSONAL_ACCESS_TOKEN=<ваш-токен>
./github-mcp-server stdio

Сборка из исходного кода

git clone https://github.com/github/github-mcp-server
cd github-mcp-server
go build -o github-mcp-server ./cmd/github-mcp-server
export GITHUB_PERSONAL_ACCESS_TOKEN=<ваш-токен>
./github-mcp-server stdio

Установка в MCP-хостах

VS Code

Добавьте в конфигурацию VS Code:

{
  "servers": {
    "github": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ваш-токен>"
      }
    }
  }
}

Claude Desktop

Добавьте в конфигурацию Claude Desktop:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ваш-токен>"
      }
    }
  }
}

Инструменты

Сервер предоставляет широкий набор инструментов, сгруппированных по функциональности.

Набор инструментов по умолчанию

По умолчанию включены следующие наборы инструментов: repos, issues, pull_requests, code_security, users, secret_protection.

Доступные наборы инструментов

Конфигурация

Переменные окружения

Флаги командной строки

Участие в разработке

Приветствуются вклады в проект! Пожалуйста, ознакомьтесь с руководством по участию для получения информации о том, как начать.

Лицензия

Этот проект распространяется под лицензией MIT — подробности см. в файле LICENSE.