GitHub MCP Server

Локальный MCP-сервер OpenCode для безопасных рабочих процессов разработчика GitHub: выполнение pull ветки main, создание функциональной ветки, её отправка (push) и открытие pull-запроса, готового к проверке.

Окружение

Установите эти переменные в вашей оболочке. Не сохраняйте реальные секретные данные в репозитории.

export GH_TOKEN="your_github_token_here"
export GITHUB_MCP_ALLOWED_ROOTS="/Users/matiasbinagora/Projects"
export GITHUB_MCP_DEFAULT_BASE_BRANCH="main"
export GITHUB_MCP_DEFAULT_REMOTE="origin"
export GITHUB_MCP_REQUIRE_CLEAN_WORKTREE="true"

Рекомендуется использовать GH_TOKEN. Если он не задан, сервер всё равно может работать, если gh уже аутентифицирован локально.

Related MCP server: GitHub MCP Server

Сборка

npm install
npm run build

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

Этот тест создает временный локальный «голый» (bare) репозиторий, выполняет pull ветки main, создает тестовую ветку, фиксирует (commit) файл, отправляет ветку (push) и проверяет наличие удаленной ветки.

npm run smoke

Интеграционное тестирование GitHub

Этот тест создает реальную ветку и PR, готовый к проверке, в настроенном тестовом репозитории.

export GITHUB_MCP_SMOKE_REPO_PATH="/Users/matiasbinagora/Projects/binagora"
npm run smoke:github

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

Добавьте это в глобальный файл конфигурации OpenCode по адресу ~/.config/opencode/opencode.json.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github": {
      "type": "local",
      "command": ["node", "/Users/matiasbinagora/Projects/github-mcp/dist/index.js"],
      "enabled": true,
      "environment": {
        "GH_TOKEN": "{env:GH_TOKEN}",
        "GITHUB_MCP_ALLOWED_ROOTS": "/Users/matiasbinagora/Projects",
        "GITHUB_MCP_DEFAULT_BASE_BRANCH": "main",
        "GITHUB_MCP_DEFAULT_REMOTE": "origin",
        "GITHUB_MCP_REQUIRE_CLEAN_WORKTREE": "true"
      }
    }
  }
}

Если OpenCode запускается до того, как ваша оболочка экспортирует GH_TOKEN, используйте вместо этого следующую команду, чтобы MCP-сервер считывал ~/.zshrc перед запуском:

"command": [
  "zsh",
  "-lc",
  "source \"$HOME/.zshrc\" >/dev/null 2>&1; exec node \"/Users/matiasbinagora/Projects/github-mcp/dist/index.js\""
]

Инструменты

• github_repo_status

• github_pull_main

• github_create_feature_branch

• github_push_feature_branch

• github_create_pull_request

• github_prepare_feature_workflow

Заметки о безопасности

• Репозитории должны находиться внутри GITHUB_MCP_ALLOWED_ROOTS.

• Инструменты для общего выполнения команд оболочки не предоставляются.

• Прямая отправка (push) в main или master запрещена.

• Принудительная отправка (force push) и удаление веток не реализованы.

• По умолчанию требуется чистая рабочая область (worktree) перед выполнением pull, созданием ветки и созданием PR.

• Имена веток проверяются с помощью git check-ref-format --branch.