gh-board-mcp

MCP-сервер для управления GitHub Projects v2 как персональной канбан-доской. Создавайте активности (черновики), перемещайте их между колонками, отслеживайте приоритет — без привязки к реальным задачам.

Требования

• Node.js >= 18

• Персональный токен доступа GitHub с областью project (точная настройка: чтение/запись проектов)

Related MCP server: GitHub Projects MCP Server

Использование

GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Настройте его в вашем MCP-клиенте (например, Claude Code):

claude mcp add gh-board-mcp -- env GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Инструменты

Статус и Приоритет

• create_project создаёт новую доску со Статусом = Todo / In Progress / Done и Приоритетом = Urgent / High / Medium / Low.

• Доски, созданные из шаблона GitHub, сохраняют свои собственные варианты Статуса/Приоритета — передавайте значения, существующие на доске. create_activity, move_activity и list_activities сообщают о допустимых вариантах при получении неизвестного значения.

• Пользовательские колонки не поддерживаются через API (настройте их в интерфейсе GitHub).

Замечания

• Ограничение чтения: list_activities и list_projects читают до 100 элементов/проектов за один вызов; более крупные доски усекаются.

• Согласованность в конечном счёте: Записи в GitHub Projects v2 могут отображаться при чтении с задержкой — вызов list_activities сразу после create_activity может временно не показывать новый элемент.

• Создание не атомарно: create_activity проверяет варианты статуса/приоритета перед созданием, поэтому неправильный вариант не оставляет следов; при временной сетевой ошибке в процессе создания может остаться черновик без заполненных полей.

Разработка

npm install
npm test
npm run build
npm run dev

Лицензия

MIT