JIRA MCP Server

Eine Model Context Protocol (MCP)-Serverimplementierung, die Zugriff auf JIRA-Daten mit Beziehungsverfolgung, optimierten Datennutzlasten und Datenbereinigung für KI-Kontextfenster bietet.

ℹ️ Es gibt einen separaten MCP-Server für Confluence

Unterstützung für Jira Cloud und Jira Server (Rechenzentrum).

Dieser MCP-Server unterstützt sowohl Jira Cloud- als auch Jira Server (Data Center) -Instanzen. Sie können den zu verwendenden Typ auswählen, indem Sie die Umgebungsvariable JIRA_TYPE festlegen:

• cloud (Standard): Für Jira Cloud (von Atlassian gehostet)

• server : Für Jira Server/Data Center (selbst gehostet)

Der Server verwendet automatisch die richtige API-Version und Authentifizierungsmethode für den ausgewählten Typ.

Related MCP server: Jira MCP Server

Merkmale

• Suchen Sie mit JQL nach JIRA-Problemen (maximal 50 Ergebnisse pro Anfrage)

• Rufen Sie epische Kinder mit Kommentarverlauf und optimierten Nutzdaten ab (maximal 100 Probleme pro Anfrage)

• Erhalten Sie detaillierte Probleminformationen, einschließlich Kommentaren und verwandten Problemen

• Erstellen, aktualisieren und verwalten Sie JIRA-Probleme

• Kommentare zu Problemen hinzufügen

• Extrahieren Sie Problemerwähnungen aus dem Atlassian-Dokumentformat

• Verfolgen Sie Problembeziehungen (Erwähnungen, Links, Eltern/Kind, Epen).

• Bereinigen und transformieren Sie umfangreichen JIRA-Inhalt für KI-Kontexteffizienz

• Unterstützung für Dateianhänge mit sicherer Verarbeitung mehrteiliger Uploads

• Unterstützt sowohl Jira Cloud- als auch Jira Server-APIs (Data Center)

Voraussetzungen

• Bun (v1.0.0 oder höher)

• JIRA-Konto mit API-Zugriff

Umgebungsvariablen

JIRA_API_TOKEN=your_api_token
JIRA_BASE_URL=your_jira_instance_url  # e.g., https://your-domain.atlassian.net
JIRA_USER_EMAIL=your_email
JIRA_TYPE=cloud   # or 'server' for Jira Server/Data Center (optional, defaults to 'cloud')

Installation und Einrichtung

1. Klonen Sie das Repository:

git clone [repository-url]
cd jira-mcp

2. Installieren Sie Abhängigkeiten und erstellen Sie:

bun install
bun run build

3. Konfigurieren Sie den MCP-Server:

Bearbeiten Sie die entsprechende Konfigurationsdatei:

macOS:

• Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

• Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

• Claude Desktop: %APPDATA%\Claude Desktop\claude_desktop_config.json

Linux:

• Cline: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Claude Desktop: existiert leider noch nicht

Fügen Sie die folgende Konfiguration unter dem Objekt mcpServers hinzu:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_BASE_URL": "your_jira_instance_url",
        "JIRA_USER_EMAIL": "your_email",
        "JIRA_TYPE": "cloud"
      }
    }
  }
}

4. Starten Sie den MCP-Server neu.

Starten Sie den MCP-Server in den MCP-Einstellungen von Cline neu. Starten Sie Claude Desktop neu, um den neuen MCP-Server zu laden.

Entwicklung

Führen Sie Tests durch:

bun test

Beobachtungsmodus für die Entwicklung:

bun run dev

So erstellen Sie den Build nach Änderungen neu:

bun run build

Verfügbare MCP-Tools

Suchprobleme

Suchen Sie mit JQL nach JIRA-Problemen. Gibt bis zu 50 Ergebnisse pro Anfrage zurück.

Eingabeschema:

{
  searchString: string; // JQL search string
}

hol_epische_Kinder

Erhalten Sie alle untergeordneten Probleme in einem Epic, einschließlich der zugehörigen Kommentare und Beziehungsdaten. Begrenzt auf 100 Probleme pro Anfrage.

Eingabeschema:

{
  epicKey: string; // The key of the epic issue
}

Problem melden

Erhalten Sie detaillierte Informationen zu einem bestimmten JIRA-Problem, einschließlich Kommentaren und allen Beziehungen.

Eingabeschema:

{
  issueId: string; // The ID or key of the JIRA issue
}

Problem erstellen

Erstellen Sie ein neues JIRA-Problem mit angegebenen Feldern.

Eingabeschema:

{
  projectKey: string, // The project key where the issue will be created
  issueType: string, // The type of issue (e.g., "Bug", "Story", "Task")
  summary: string, // The issue summary/title
  description?: string, // Optional issue description
  fields?: { // Optional additional fields
    [key: string]: any
  }
}

Update-Problem

Aktualisieren Sie die Felder eines vorhandenen JIRA-Problems.

Eingabeschema:

{
  issueKey: string, // The key of the issue to update
  fields: { // Fields to update
    [key: string]: any
  }
}

Anhang hinzufügen

Fügen Sie einem JIRA-Problem einen Dateianhang hinzu.

Eingabeschema:

{
  issueKey: string, // The key of the issue
  fileContent: string, // Base64 encoded file content
  filename: string // Name of the file to be attached
}

Kommentar hinzufügen

Fügen Sie einem JIRA-Problem einen Kommentar hinzu. Akzeptiert Klartext und konvertiert ihn intern in das erforderliche Atlassian-Dokumentformat.

Eingabeschema:

{
  issueIdOrKey: string, // The ID or key of the issue to add the comment to
  body: string // The content of the comment (plain text)
}

Datenbereinigungsfunktionen

• Extrahiert Text aus dem Atlassian Document Format

• Verfolgt Erwähnungen von Problemen in Beschreibungen und Kommentaren

• Verwaltet formale Problemverknüpfungen mit Beziehungstypen

• Bewahrt die Eltern-Kind-Beziehungen

• Verfolgt epische Assoziationen

• Enthält einen Kommentarverlauf mit Autoreninformationen

• Entfernt unnötige Metadaten aus Antworten

• Verarbeitet Inhaltsknoten rekursiv auf Erwähnungen

• Dedupliziert Problemerwähnungen

Technische Details

• Erstellt mit TypeScript im strikten Modus

• Verwendet die Bun-Laufzeit für verbesserte Leistung

• Vite für optimierte Builds

• Verwendet JIRA REST API v3

• Grundlegende Authentifizierung mit API-Token

• Gebündelte API-Anfragen für zugehörige Daten

• Optimierte Antwortnutzlasten für KI-Kontextfenster

• Effiziente Transformation komplexer Atlassian-Strukturen

• Robuste Fehlerbehandlung

• Überlegungen zur Ratenbegrenzung

• Höchstgrenzen:

  • Suchergebnisse: 50 Probleme pro Anfrage

  • Epische Kinder: 100 Ausgaben pro Anfrage

• Unterstützung mehrteiliger Formulardaten für sichere Dateianhänge

• Automatische Erkennung und Validierung von Inhaltstypen

Fehlerbehandlung

Der Server implementiert eine umfassende Fehlerbehandlungsstrategie:

• Netzwerkfehlererkennung und entsprechende Meldung

• Handhabung von HTTP-Statuscodes (insbesondere 404 bei Problemen)

• Detaillierte Fehlermeldungen mit Statuscodes

• Protokollierung der Fehlerdetails in der Konsole

• Eingabevalidierung für alle Parameter

• Sichere Fehlerweiterleitung durch MCP-Protokoll

• Spezialisierte Behandlung häufiger JIRA-API-Fehler

• Base64-Validierung für Anhänge

• Fehlerbehandlung mehrteiliger Anfragen

• Ratenbegrenzungserkennung

• Validierung der Anhangsparameter

LIZENZ

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENCE .