github-projects-mcp

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

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:

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

1. Klonen Sie das Repository:
   git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp
2. Erstellen und aktivieren Sie eine virtuelle Umgebung:
   uv venv source venv/bin/activate
3. Installieren Sie Abhängigkeiten:
   uv pip install -e .
4. 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:

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:

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