gh-board-mcp

MCP-Server zur Verwaltung von GitHub Projects v2 als persönliches Kanban-Board. Erstelle Aktivitäten (Entwurfselemente), verschiebe sie zwischen Spalten, verfolge Prioritäten – ohne Verknüpfung mit echten Issues.

Voraussetzungen

• Node.js >= 18

• Ein GitHub Personal Access Token mit dem project-Bereich (feingranular: Projekte lesen/schreiben)

Related MCP server: GitHub Projects MCP Server

Verwendung

GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Konfiguriere ihn in deinem MCP-Client (z. B. Claude Code):

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

Werkzeuge

Status & Priorität

• create_project erstellt ein neues Board mit Status = Zu erledigen / In Bearbeitung / Erledigt und Priorität = Dringend / Hoch / Mittel / Niedrig.

• Boards, die aus einer GitHub-Vorlage erstellt wurden, behalten ihre eigenen Status-/Prioritätsoptionen – übergebe Werte, die auf dem Board existieren. create_activity, move_activity und list_activities melden die gültigen Optionen, wenn ein unbekannter Wert übergeben wird.

• Benutzerdefinierte Spalten werden über die API nicht unterstützt (konfiguriere sie in der GitHub-Benutzeroberfläche).

Hinweise

• Lesebegrenzung: list_activities und list_projects lesen bis zu 100 Elemente/Projekte pro Aufruf; größere Boards werden abgeschnitten.

• Letztliche Konsistenz: Schreibvorgänge in GitHub Projects v2 können einen Moment dauern, bis sie in Lesevorgängen sichtbar werden – ein list_activities direkt nach create_activity könnte das neue Element kurzzeitig übersehen.

• Erstellen ist nicht atomar: create_activity validiert die Status-/Prioritätsoptionen vor dem Erstellen, sodass eine ungültige Option nichts zurücklässt; ein vorübergehender Netzwerkfehler während des Erstellens kann dennoch einen Entwurf ohne seine Feldwerte hinterlassen.

Entwicklung

npm install
npm test
npm run build
npm run dev

Lizenz

MIT