GitHub Projects V2 MCP-Server

Ein Model Context Protocol (MCP)-Server, der Tools zur Verwaltung von GitHub Projects V2 über Claude und andere MCP-Clients bereitstellt. Dieser Server nutzt die GitHub GraphQL-API für die Interaktion mit GitHub Projects V2.

Merkmale

Auflisten und Anzeigen von GitHub-Projekten V2 für Benutzer und Organisationen
Abrufen von Projektfeldern und -elementen (Probleme, PRs, Problementwürfe)
Probleme erstellen und zu Projekten hinzufügen
Erstellen Sie Entwurfsprobleme direkt in Projekten
Aktualisieren Sie die Feldwerte der Projektelemente
Elemente aus Projekten löschen

Related MCP server: GitHub MCP Server Plus

Verwendung

Dieser Server kann mit jedem MCP-Client, z. B. Claude Desktop, verwendet werden. Fügen Sie ihn Ihrer MCP-Clientkonfiguration hinzu (z. B. claude_desktop_config.json ).

Option 1: Verwenden des veröffentlichten Pakets

Hier ist eine Beispielkonfiguration mit uvx als Befehls-Runner:

{ "mcpServers": { "github-projects": { "command": "uvx", "args": [ "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

Stellen Sie sicher, dass Sie your_pat_here durch Ihr tatsächliches persönliches GitHub-Zugriffstoken ersetzen.

Option 2: Aus dem Quellcode

Um das Projekt direkt aus dem Quellcode auszuführen, führen Sie die folgenden Schritte aus:

Aufstellen

Klonen Sie das Repository:
git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp
Erstellen und aktivieren Sie eine virtuelle Umgebung:
uv venv source venv/bin/activate
Installieren Sie Abhängigkeiten:
uv pip install -e .
Legen Sie Ihr GitHub-Token als Umgebungsvariable fest:
Erstellen Sie ein persönliches GitHub-Zugriffstoken und erteilen Sie ihm die erforderlichen Berechtigungen. Die erforderlichen Berechtigungen sind: repo , project und read:org .
Fügen Sie das Token Ihrer .env Datei hinzu, nachdem Sie diesen Befehl ausgeführt haben:
cp .env.example .env
Fügen Sie dann Folgendes zu Ihrer .env Datei hinzu:
export GITHUB_TOKEN=your_personal_access_token

Verwendung aus dem Quellcode

Konfigurieren Sie Ihren MCP-Client bei Verwendung des Quellcodes wie folgt:

{ "mcpServers": { "github-projects": { "command": "uv", "args": [ "--directory", "/path/to/github-projects-mcp", "run", "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

Stellen Sie sicher, dass Sie /path/to/github-projects-mcp und your_pat_here durch Ihren tatsächlichen Repository-Pfad und Ihr persönliches GitHub-Zugriffstoken ersetzen.

Verfügbare Tools

list_projects : Listet GitHub-Projekte V2 für eine bestimmte Organisation oder einen bestimmten Benutzer auf
get_project_fields : Ruft die in einem GitHub-Projekt V2 verfügbaren Felder ab
get_project_items : Ruft Elemente in einem GitHub-Projekt V2 ab (unterstützt das Filtern nach Status oder benutzerdefinierten Einzelauswahlfeldern)
create_issue : Erstellt ein neues GitHub-Problem
add_issue_to_project : Fügen Sie einem Projekt V2 ein vorhandenes GitHub-Problem hinzu
update_project_item_field : Aktualisieren Sie einen Feldwert für ein Projektelement
create_draft_issue : Erstellen Sie einen Problementwurf direkt in einem GitHub-Projekt V2
delete_project_item : Löscht ein Element aus einem GitHub-Projekt V2

Ausführliche Informationen zur Verwendung finden Sie in der Tooldokumentation im Servercode.

Entwicklung

Das Projekt ist wie folgt strukturiert:

src/github_projects_mcp/ : Hauptpaketverzeichnis
- server.py : MCP-Serverimplementierung mit Tooldefinitionen
- github_client.py : GraphQL-Client für GitHub-API-Interaktionen

Um einen Beitrag zu leisten, stellen Sie Folgendes sicher:

Fügen Sie für alle GraphQL-Operationen eine ordnungsgemäße Fehlerbehandlung hinzu
Fügen Sie Typanmerkungen für alle Funktionen und Parameter hinzu
Aktualisieren Sie die Dokumentation, wenn Sie neue Tools oder Funktionen hinzufügen