mcp-github-push

Легковесный MCP-сервер, который даёт Claude (или другому MCP-клиенту) возможность пушить проекты прямо на GitHub без git clone/git pull на вашем компьютере. Создан как альтернатива стандартному коннектору GitHub, которая экономит токены и не засоряет локальное хранилище.

Имеет вид терминального CLI — устанавливается через npm, токен настраивается один раз, после чего сервер регистрируется в вашем MCP-клиенте.

Чем это отличается от встроенного коннектора GitHub?

• Не клонирует репозиторий на диск. Все операции выполняются напрямую через GitHub REST/Git Data API, поэтому локальное хранилище не расходуется.

• Один коммит для множества файлов. Используется Git Data API (blob → tree → commit → ref), чтобы изменения многих файлов попадали в один аккуратный коммит, а не в спам из коммитов по одному на файл.

• Обязательное подтверждение перед пушем. Есть инструмент github_preview_push, который нужно вызвать первым для отображения сводки изменений; github_push_confirmed можно вызывать только после явного согласия пользователя.

• Токен хранится локально и безопасно. Файл конфигурации имеет права 600 и доступен только владельцу-пользователю.

Related MCP server: ship-it-mcp

Установка

Вариант A — Без Node.js (готовый исполняемый файл)

Node.js вообще не нужен. Скачайте бинарник под вашу ОС со страницы Releases:

• Windows: mcp-github-push-win-x64.exe

• Linux: mcp-github-push-linux-x64

• macOS: mcp-github-push-macos-x64

Запустите из терминала:

# Windows (PowerShell/CMD)
mcp-github-push-win-x64.exe setup

# Linux/macOS
chmod +x mcp-github-push-linux-x64
./mcp-github-push-linux-x64 setup

Затем укажите полный путь к exe-файлу в конфиге MCP-клиента:

{
  "mcpServers": {
    "github-push": {
      "command": "C:\\path\\ke\\mcp-github-push-win-x64.exe",
      "args": ["start"]
    }
  }
}

Вариант B — Через npm (нужен Node.js 18+)

npx @kintil555/mcp-github-push setup

Следуйте инструкциям:

1. Создайте Personal Access Token (рекомендуется fine-grained) с правами Contents: Read and write для нужного репозитория.

2. Вставьте токен по запросу (ввод скрывается в терминале).

3. Токен автоматически проверяется и сохраняется в ~/.config/mcp-github-push/config.json.

Регистрация в MCP-клиенте

Добавьте в конфиг вашего MCP-клиента (например, claude_desktop_config.json для Claude Desktop):

{
  "mcpServers": {
    "github-push": {
      "command": "npx",
      "args": ["-y", "@kintil555/mcp-github-push", "start"]
    }
  }
}

Перезапустите клиент. Доступные для Claude инструменты:

Другие команды CLI

npx @kintil555/mcp-github-push status   # cek token masih valid
npx @kintil555/mcp-github-push logout   # hapus token tersimpan

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

git clone https://github.com/kintil555/mcp-github-push.git
cd mcp-github-push
npm install
npm run build

в GitHub Actions автоматически собирает ияет типы при каждом пуше/PR в main, а также публикует в npm при создании нового тега релиза.

Безопасность

• Токен хранится в ~/.config/mcp-github-push/config.json с правами 600.

• Используйте fine-grained PAT, ограниченный конкретным репозиторием, а не классический токен с полным доступом.

• Устанавливайте срок действия токена и регулярно его ротируйте.

• github_push_confirmed спроектирован так, чтобы модель ИИ не могла запушить без параметра confirmed: true — убедитесь, что ваш MCP-клиент также показывает вызовы инструментов для проверки пользователем перед выполнением.

Лицензия

MIT