GitHub MCP Server

Пользовательский MCP-сервер (Model Context Protocol), написанный на TypeScript, который подключает Claude к REST API GitHub.

Возможности

Предоставляет 6 инструментов (tools), которые Claude может вызывать:

Related MCP server: remote-mcp-oauth-github

1. Генерация GitHub Personal Access Token

1. Перейдите в GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens

2. Создайте токен с минимально необходимыми разрешениями:

   • Contents: Read (для get_file_content)

   • Issues: Read and write (для list_issues/create_issue)

   • Metadata: Read (обязательно всегда)

3. Скопируйте сгенерированный токен (начинается с github_pat_...)

Совет по безопасности: никогда не коммитьте токен в репозиторий. Используйте переменную окружения.

2. Установка и сборка

npm install
npm run build

Это создаёт build/index.js, который является исполняемым файлом сервера (общение через stdio — стандартный протокол MCP).

3. Локальное тестирование (опционально, без Claude)

export GITHUB_PERSONAL_ACCESS_TOKEN="seu_token_aqui"
npm start

Если в stderr появится GitHub MCP server rodando via stdio., значит, всё работает. Для интерактивного тестирования tools используйте MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

4. Подключение к Claude Desktop

Отредактируйте файл конфигурации Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/caminho/absoluto/para/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Перезапустите Claude Desktop. Инструменты GitHub должны появиться на значке инструментов (🔨) в беседе.

5. Следующие шаги (идеи для расширения и прокачки портфолио)

• Добавить инструменты записи: create_pull_request, merge_pull_request, create_branch

• Добавить настоящую пагинацию (cursor-based) вместо только per_page

• Rate limiting и кэш (GitHub ограничивает 5000 запросов в час для аутентифицированных пользователей)

• Автоматические тесты с Vitest/Jest

• CI с GitHub Actions, запускающий lint + тесты + сборку при каждом push

• Опубликовать как npm-пакет (npx github-mcp-server)

• Докеризировать сервер (хороший способ связать его с вашими другими DevOps-проектами)

Структура проекта

github-mcp-server/
├── src/
│   └── index.ts      # lógica do servidor e definição das tools
├── build/             # gerado pelo `npm run build`
├── package.json
├── tsconfig.json
└── README.md