github-mcp

MCP-сервер для REST API GitHub — 1112 инструментов, охватывающих все 44 категории API.

Автоматически сгенерирован из OpenAPI-спецификации GitHub с помощью генератора кода, который создает типизированные определения инструментов с проверкой Zod.

Установка

npm install github-rest-mcp

Или из GitHub Packages:

npm install @eyalm321/github-mcp

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

Установите ваш персональный токен доступа GitHub (Personal Access Token):

export GITHUB_TOKEN=ghp_your_token_here

Фильтр категорий

По умолчанию зарегистрированы все 1112 инструментов. Чтобы включить только определенные категории:

export GITHUB_MCP_CATEGORIES=repos,issues,pulls,actions

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-rest-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "GITHUB_MCP_CATEGORIES": "repos,issues,pulls,actions,users,orgs,git,search"
      }
    }
  }
}

Категории API

Именование инструментов

Инструменты следуют шаблону github_{category}_{action}, производному от идентификаторов операций GitHub:

• github_repos_get — Получить репозиторий

• github_issues_create — Создать задачу (issue)

• github_pulls_list — Список запросов на слияние (pull requests)

• github_actions_list_workflow_runs — Список запусков рабочих процессов (workflow runs)

Разработка

# Install dependencies
npm install

# Regenerate tools from OpenAPI spec
npm run generate

# Build
npm run build

# Run tests
npm test

# Start the server
npm start

Перегенерация инструментов

Файлы инструментов в src/tools/ автоматически генерируются из OpenAPI-спецификации GitHub. Для обновления:

# Delete cached spec to force re-download
rm -f api-description.json

# Regenerate
npm run generate

Лицензия

MIT