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