GitHub MCP Server Plus

GitHub MCP Сервер Плюс

Сервер MCP для API GitHub, обеспечивающий файловые операции, управление репозиториями, функции поиска и многое другое.

Функции

• Автоматическое создание веток : при создании/обновлении файлов или отправке изменений автоматически создаются ветки, если они не существуют.
• Комплексная обработка ошибок : понятные сообщения об ошибках для распространенных проблем
• Сохранение истории Git : операции поддерживают правильную историю Git без принудительной отправки
• Пакетные операции : поддержка как однофайловых, так и многофайловых операций с содержимым или путями к файлам.
• Расширенный поиск : поддержка поиска по коду, проблемам/PR и пользователям.

Инструменты

1. create_or_update_file
   • Создать или обновить отдельный файл в репозитории
   • Входные данные:
     • owner (строка): Владелец репозитория (имя пользователя или организация)
     • repo (строка): Имя репозитория
     • path (строка): Путь, по которому необходимо создать/обновить файл.
     • content (строка): Содержимое файла
     • message (строка): сообщение о фиксации
     • branch (строка): ветвь для создания/обновления файла
     • sha (необязательная строка): SHA заменяемого файла (для обновлений)
   • Возвращает: содержимое файла и сведения о фиксации
2. push_files_content
   • Отправка нескольких файлов с прямым содержимым в один коммит
   • Входные данные:
     • owner (строка): Владелец репозитория
     • repo (строка): Имя репозитория
     • branch (строка): ветвь, в которую нужно отправить
     • files (массив): файлы для отправки, каждый с path и content
     • message (строка): сообщение о фиксации
   • Возврат: обновленная ссылка на ветку
3. push_files_from_path
   • Передача нескольких файлов из путей файловой системы за один коммит
   • Входные данные:
     • owner (строка): Владелец репозитория
     • repo (строка): Имя репозитория
     • branch (строка): ветвь для отправки
     • files (массив): Файлы для отправки, каждый из которых содержит:
       • path (строка): Целевой путь в репозитории
       • filepath (строка): Исходный путь файловой системы для чтения
     • message (строка): сообщение о фиксации
   • Возврат: обновленная ссылка на ветку
4. search_repositories
   • Поиск репозиториев GitHub
   • Входные данные:
     • query (строка): Поисковый запрос
     • page (необязательное число): Номер страницы для нумерации страниц
     • perPage (необязательное число): Результаты на страницу (макс. 100)
   • Возвращает: Результаты поиска в репозитории
5. create_repository
   • Создать новый репозиторий GitHub
   • Входные данные:
     • name (строка): Имя репозитория
     • description (необязательная строка): Описание репозитория
     • private (необязательно логическое значение): должен ли репозиторий быть частным
     • autoInit (необязательно логическое значение): инициализация с помощью README
   • Возвращает: Созданные данные репозитория
6. get_file_contents
   • Получить содержимое файла или каталога
   • Входные данные:
     • owner (строка): Владелец репозитория
     • repo (строка): Имя репозитория
     • path (строка): Путь к файлу/каталогу
     • branch (необязательная строка): ветвь, из которой нужно получить содержимое
   • Возвращает: содержимое файла/каталога
7. create_issue
   • Создать новый выпуск
   • Входные данные:
     • owner (строка): Владелец репозитория
     • repo (строка): Имя репозитория
     • title (строка): Название выпуска
     • body (необязательная строка): Описание проблемы
     • assignees (необязательная строка[]): Имена пользователей для назначения
     • labels (необязательно string[]): Метки для добавления
     • milestone (необязательное число): Номер вехи
   • Возвраты: Созданные детали проблемы
8. create_pull_request
   • Создать новый запрос на извлечение
   • Входные данные:
     • owner (строка): Владелец репозитория
     • repo (строка): Имя репозитория
     • title (строка): заголовок PR
     • body (необязательная строка): описание PR
     • head (строка): Ветка, содержащая изменения
     • base (строка): Ветка для слияния
     • draft (необязательно логическое значение): создать как черновик PR
     • maintainer_can_modify (необязательное логическое значение): Разрешить редактирование сопровождающим
   • Возвращает: Созданные данные запроса на вытягивание
9. fork_repository
   • Форк репозитория
   • Входные данные:
     • owner (строка): Владелец репозитория
     • repo (строка): Имя репозитория
     • organization (необязательная строка): Организация, в которую будет произведен форк
   • Возвращает: сведения о разветвленном репозитории
10. create_branch

• Создать новую ветку
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • branch (строка): Имя новой ветви
  • from_branch (необязательная строка): Исходная ветка (по умолчанию — репозиторий по умолчанию)
• Возвращает: Созданная ссылка на ветку

11. list_issues

• Список и фильтрация проблем репозитория
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • state (необязательная строка): Фильтр по состоянию («открыто», «закрыто», «все»)
  • labels (необязательная строка[]): Фильтр по меткам
  • sort (необязательная строка): Сортировать по («создано», «обновлено», «комментарии»)
  • direction (необязательная строка): Направление сортировки ('asc', 'desc')
  • since (необязательная строка): Фильтр по дате (временная метка ISO 8601)
  • page (необязательное число): Номер страницы
  • per_page (необязательное число): Результаты на страницу
• Возвраты: Массив деталей выпуска

12. update_issue

• Обновить существующую проблему
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • issue_number (номер): Номер выпуска для обновления
  • title (необязательная строка): Новый заголовок
  • body (необязательная строка): Новое описание
  • state (необязательная строка): Новое состояние («открыто» или «закрыто»)
  • labels (необязательная строка[]): Новые метки
  • assignees (необязательная строка[]): Новые получатели
  • milestone (необязательный номер): Новый номер вехи
• Возврат: обновленные сведения о проблеме

13. add_issue_comment

• Добавить комментарий к проблеме
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • issue_number (число): Номер вопроса для комментария
  • body (строка): Текст комментария
• Возвращает: Созданные детали комментария

14. search_code

• Поиск кода в репозиториях GitHub
• Входные данные:
  • q (строка): Поисковый запрос с использованием синтаксиса поиска кода GitHub
  • sort (необязательная строка): поле сортировки (только «индексированное»)
  • order (необязательная строка): порядок сортировки ('asc' или 'desc')
  • per_page (необязательное число): Результаты на страницу (макс. 100)
  • page (необязательное число): Номер страницы
• Возвращает: результаты поиска кода с контекстом репозитория.

15. search_issues

• Поиск проблем и запросов на извлечение
• Входные данные:
  • q (строка): Поисковый запрос с использованием GitHub вызывает проблемы с синтаксисом поиска
  • sort (необязательная строка): поле сортировки (комментарии, реакции, создано и т. д.)
  • order (необязательная строка): порядок сортировки ('asc' или 'desc')
  • per_page (необязательное число): Результаты на страницу (макс. 100)
  • page (необязательное число): Номер страницы
• Возвращает: результаты поиска по проблемам и запросам на извлечение

16. search_users

• Поиск пользователей GitHub
• Входные данные:
  • q (строка): Поисковый запрос с использованием синтаксиса поиска пользователей GitHub
  • sort (необязательная строка): поле сортировки (подписчики, репозитории, присоединившиеся)
  • order (необязательная строка): порядок сортировки ('asc' или 'desc')
  • per_page (необязательное число): Результаты на страницу (макс. 100)
  • page (необязательное число): Номер страницы
• Возвращает: Результаты поиска пользователя

17. list_commits

• Получает коммиты ветки в репозитории
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • page (необязательная строка): номер страницы
  • per_page (необязательная строка): количество записей на странице
  • sha (необязательная строка): имя ветки
• Возвращает: Список коммитов

18. get_issue

• Получает содержимое проблемы в репозитории
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • issue_number (число): Номер выпуска для извлечения
• Возвращает: объект и подробности проблемы GitHub

19. get_pull_request

• Получите подробную информацию о конкретном запросе на извлечение
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
• Возвращает: сведения о запросе на извлечение, включая различия и статус проверки.

20. list_pull_requests

• Список и фильтрация запросов на извлечение из репозитория
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • state (необязательная строка): Фильтр по состоянию («открыто», «закрыто», «все»)
  • head (необязательная строка): Фильтр по пользователю/организации head и ветке
  • base (необязательная строка): Фильтр по базовой ветке
  • sort (необязательная строка): Сортировать по («создано», «обновлено», «популярность», «длительно работает»)
  • direction (необязательная строка): Направление сортировки ('asc', 'desc')
  • per_page (необязательное число): Результаты на страницу (макс. 100)
  • page (необязательное число): Номер страницы
• Возвращает: Массив данных запроса на вытягивание

21. create_pull_request_review

• Создайте обзор на запрос на извлечение
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
  • body (строка): Текст комментария к отзыву
  • event (строка): Действие обзора ('APPROVE', 'REQUEST_CHANGES', 'COMMENT')
  • commit_id (необязательная строка): SHA коммита для проверки
  • comments (необязательный массив): комментарии к конкретным строкам, каждый из которых содержит:
    • path (строка): Путь к файлу
    • position (номер): Позиция строки в разнице
    • body (строка): Текст комментария
• Возврат: Созданные детали обзора

22. merge_pull_request

• Объединить запрос на извлечение
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
  • commit_title (необязательная строка): заголовок для слияния коммита
  • commit_message (необязательная строка): Дополнительные сведения о слиянии.
  • merge_method (необязательная строка): Метод слияния ('merge', 'squash', 'rebase')
• Возвраты: сведения о результатах слияния

23. get_pull_request_files

• Получить список файлов, измененных в запросе на извлечение
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
• Возвращает: Массив измененных файлов с подробностями исправления и статуса.

24. get_pull_request_status

• Получите объединенный статус всех проверок статуса для запроса на извлечение
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
• Возвраты: объединенные результаты проверки статуса и данные индивидуальной проверки

25. update_pull_request_branch

• Обновите ветку запроса на извлечение с последними изменениями из базовой ветки.
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
  • expected_head_sha (необязательная строка): ожидаемый SHA HEAD-ссылки запроса на извлечение
• Возвращает: сообщение об успешном завершении обновления ветки.

26. get_pull_request_comments

• Получите комментарии к отзыву о запросе на включение изменений
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
• Возвращает: Массив комментариев к отзывам о запросе на включение внесенных изменений

27. get_pull_request_reviews

• Получите отзывы о запросе на включение внесенных изменений
• Входные данные:
  • owner (строка): Владелец репозитория
  • repo (строка): Имя репозитория
  • pull_number (число): Номер запроса на извлечение
• Возвращает: Массив отзывов о запросах на включение внесенных изменений

Синтаксис поискового запроса

Поиск кода

• language:javascript : Поиск по языку программирования
• repo:owner/name : Поиск в определенном репозитории
• path:app/src : Поиск по указанному пути
• extension:js : Поиск по расширению файла
• Пример: q: "import express" language:typescript path:src/

Поиск проблем

• is:issue или is:pr : Фильтр по типу
• is:open или is:closed : Фильтр по штату
• label:bug : Поиск по метке
• author:username : Поиск по автору
• Пример: q: "memory leak" is:issue is:open label:bug

Поиск пользователей

• type:user или type:org : Фильтр по типу учетной записи
• followers:>1000 : Фильтр по подписчикам
• location:London : Поиск по местоположению
• Пример: q: "fullstack developer" location:London followers:>100

Подробный синтаксис поиска см. в документации по поиску GitHub .

Настраивать

Персональный токен доступа

Создайте токен персонального доступа GitHub с соответствующими разрешениями:

• Перейдите в раздел Персональные токены доступа (в настройках GitHub > Настройки разработчика)
• Выберите, к каким репозиториям вы хотите предоставить доступ этому токену (Public, All или Select).
• Создать токен с областью действия repo («Полный контроль над приватными репозиториями»)
  • В качестве альтернативы, если вы работаете только с публичными репозиториями, выберите только область public_repo
• Скопируйте сгенерированный токен

Использование с Claude Desktop

Чтобы использовать это с Claude Desktop, добавьте следующее в ваш claude_desktop_config.json :

Докер

НПХ

Строить

Сборка Docker:

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.