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 .

Deploy Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

JIRA MCP Server

JIRA MCP Server

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

Merkmale

Voraussetzungen

Umgebungsvariablen

Installation und Einrichtung

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten und erstellen Sie:

3. Konfigurieren Sie den MCP-Server:

4. Starten Sie den MCP-Server neu.

Entwicklung

Verfügbare MCP-Tools

Suchprobleme

hol_epische_Kinder

Problem melden

Problem erstellen

Update-Problem

Anhang hinzufügen

Kommentar hinzufügen

Datenbereinigungsfunktionen

Technische Details

Fehlerbehandlung

LIZENZ

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API