GitHub MCP Server 🚀

Пользовательский сервер Model Context Protocol (MCP), созданный с помощью Node.js и TypeScript. Этот сервер позволяет любому MCP-совместимому ИИ-ассистенту (например, Gemini Code Assist, Claude Desktop, Roo Code и т. д.) напрямую взаимодействовать с вашей учётной записью GitHub.

✨ Возможности (доступные инструменты)

Этот сервер предоставляет вашему ИИ-ассистенту 7 мощных инструментов:

1. create_repository: Создать новый публичный или приватный репозиторий.

2. get_my_repositories: Вывести список последних обновлённых репозиториев аутентифицированного пользователя.

3. get_repository: Получить сведения о конкретном репозитории.

4. get_file_content: Прочитать точное содержимое любого файла в репозитории для анализа кода.

5. search_code: Искать функции, ключевые слова или синтаксис в репозиториях.

6. create_issue: Открыть новый issue в конкретном репозитории.

7. list_issues: Просмотреть открытые issues для репозитория.

🛠️ Установка и настройка

1. Клонируйте репозиторий:

   git clone [https://github.com/YOUR_USERNAME/mcp-github-server.git](https://github.com/YOUR_USERNAME/mcp-github-server.git)
   cd mcp-github-server
   Install dependencies:

Bash npm install Соберите проект:

Bash npm run build

🔑 Как получить токен GitHub

Чтобы этот сервер мог действовать от вашего имени, вам понадобится персональный токен доступа (PAT) от GitHub.

Перейдите в настройки своей учётной записи GitHub.

Перейдите в Developer settings (внизу левой боковой панели).

Нажмите Personal access tokens -> Tokens (classic).

Нажмите Generate new token (classic).

Укажите имя для токена (например, "MCP Server").

Необходимые разрешения:

Установите флажок repo (это даёт полный контроль над приватными репозиториями, что требуется для создания репозиториев, чтения файлов и управления issues).

Прокрутите вниз и нажмите Generate token.

Скопируйте токен сразу же (он начинается с ghp_...).

Настройка окружения Создайте файл .env в корневом каталоге проекта:

Bash touch .env Добавьте свой токен в файл .env:

мфрагмент кода GITHUB_TOKEN=ваш_сгенерированный_токен_здесь 🔌 Подключение к вашей IDE / ИИ-клиенту Чтобы использовать этот сервер с IDE или расширением, поддерживающим MCP, вам нужно настроить параметры MCP вашего клиента (обычно это файл mcp.json или mcp_config.json), указав путь к собранному файлу index.js.

Пример конфигурации:

JSON { "mcpServers": { "github-mcp": { "command": "node", "args": [ "--no-warnings", "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js" ], "env": { "GITHUB_TOKEN": "your_generated_token_here" } } } }

Примечание: обязательно замените ABSOLUTE_PATH_TO_YOUR_PROJECT на фактический путь на вашем компьютере.

🤝 Вклад в проект Это небольшой учебный проект! Если вы хотите добавить больше инструментов (например, управление pull request или чтение коммитов), смело делайте форк репозитория и отправляйте Pull Request.