MCP Jira Integration

Ein einfacher Model Context Protocol (MCP)-Server für Jira, der es LLMs ermöglicht, als Projektmanager und persönliche Assistenten für Teams zu fungieren, die Jira verwenden.

Merkmale

Kern-MCP-Tools

• create_issue – Neue Jira-Probleme mit der richtigen Formatierung erstellen

• search_issues – Probleme mit JQL und intelligenter Formatierung suchen

• get_sprint_status - Erhalten Sie umfassende Sprint-Fortschrittsberichte

• get_team_workload - Analysieren Sie die Arbeitsbelastung und Kapazität der Teammitglieder

• generate_standup_report - Tägliche Standup-Berichte automatisch generieren

Projektmanagement-Funktionen

• Sprint-Fortschrittsverfolgung mit visuellen Indikatoren

• Team-Arbeitslastanalyse und Kapazitätsplanung

• Automatisierte tägliche Standup-Berichtserstellung

• Problemerstellung mit entsprechender Priorisierung

• Intelligente Suche und Filterung von Problemen

Related MCP server: JIRA MCP Server

Anforderungen

• Python 3.8 oder höher

• Jira-Konto mit API-Token

• MCP-kompatibler Client (wie Claude Desktop)

Schnelle Einrichtung

1. Klonen und installieren :

cd mcp-jira-implementation/mcp-jira
pip install -e .

2. Konfigurieren Sie Jira-Anmeldeinformationen in .env :

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your.email@domain.com
JIRA_API_TOKEN=your_api_token
PROJECT_KEY=PROJ
DEFAULT_BOARD_ID=123

3. Führen Sie den MCP-Server aus :

python -m mcp_jira.simple_mcp_server

Anwendungsbeispiele

Probleme erstellen

„Erstellen Sie einen Fehler mit hoher Priorität, weil das Anmeldesystem nicht ordnungsgemäß funktioniert.“

• Automatische Zuordnung von Problemtyp, Priorität und Formatierung

Sprint-Management

„Wie ist unser aktueller Sprintstatus?“

• Erhält einen umfassenden Fortschrittsbericht mit Messdaten und visuellen Indikatoren

Teammanagement

„Zeigen Sie mir die Teamarbeitsbelastung für john.doe, jane.smith, mike.wilson“

• Analysiert die Kapazität und sorgt für eine Verteilung der Arbeitslast

Tägliche Stand-ups

„Erstellen Sie den heutigen Standup-Bericht“

• Erstellt formatierten Bericht mit abgeschlossenen, laufenden und blockierten Elementen

MCP-Integration

Mit Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "mcp-jira": {
      "command": "python",
      "args": ["-m", "mcp_jira.simple_mcp_server"],
      "cwd": "/path/to/mcp-jira"
    }
  }
}

Mit anderen MCP-Clients

Der Server folgt dem Standard-MCP-Protokoll und funktioniert mit jedem MCP-kompatiblen Client.

Konfiguration

Erforderliche Umgebungsvariablen

• JIRA_URL – Ihre Jira-Instanz-URL

• JIRA_USERNAME – Ihr Jira-Benutzername/Ihre Jira-E-Mail

• JIRA_API_TOKEN – Ihr Jira-API-Token

• PROJECT_KEY - Standard-Projektschlüssel für Vorgänge

Optionale Einstellungen

• DEFAULT_BOARD_ID – Standardboard für Sprintvorgänge

• DEBUG_MODE – Debug-Protokollierung aktivieren (Standard: false)

• LOG_LEVEL – Protokollierungsebene (Standard: INFO)

Jira-API-Token erhalten

1. Gehen Sie zu den Atlassian-Kontoeinstellungen

2. Klicken Sie auf „API-Token erstellen“.

3. Geben Sie ihm einen Namen und kopieren Sie das Token

4. Verwenden Sie Ihre E-Mail als Benutzernamen und das Token als Passwort

Architektur

Bei dieser Implementierung steht die Einfachheit im Vordergrund:

• Einzelne MCP-Serverdatei – Alle Tools an einem Ort

• Standard-MCP-Protokoll – Verwendet das offizielle MCP SDK

• Umfangreiche Formatierung – Bietet schöne, lesbare Berichte

• Fehlerbehandlung – Sanfte Behandlung von Jira-API-Problemen

• Asynchrone Unterstützung – Schnelle und reaktionsschnelle Vorgänge

Fehlerbehebung

Häufige Probleme

1. „Kein aktiver Sprint gefunden“

   • Stellen Sie sicher, dass Ihr Vorstand einen aktiven Sprint hat

   • Überprüfen Sie, ob DEFAULT_BOARD_ID richtig eingestellt ist

2. Authentifizierungsfehler

   • Überprüfen Sie, ob Ihr API-Token korrekt ist

   • Überprüfen Sie, ob Ihr Benutzername mit Ihrer E-Mail-Adresse übereinstimmt

3. Berechtigungsfehler

   • Stellen Sie sicher, dass Ihr Jira-Benutzer über die entsprechenden Projektberechtigungen verfügt

   • Überprüfen Sie, ob der Projektschlüssel vorhanden ist und Sie Zugriff haben

Debug-Modus

Legen Sie DEBUG_MODE=true in Ihrer .env Datei für eine detaillierte Protokollierung fest.

Beitragen

1. Forken Sie das Repository

2. Nehmen Sie Ihre Änderungen vor

3. Testen Sie mit Ihrer Jira-Instanz

4. Senden einer Pull-Anfrage

Lizenz

MIT-Lizenz – siehe LICENSE-Datei