Skip to main content
Glama
Sign In
deenesjakoruzh

JIRA MCP Server

by cosmix
npmGitHub
TypeScript
MIT License
114
18
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides access to JIRA data including searching issues, retrieving epic children, getting detailed issue information, creating and updating issues, extracting issue mentions, tracking issue relationships, handling file attachments, and transforming JIRA content for AI context windows

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

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

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

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" } } } }

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 } }

Aktualisierungsproblem

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 .

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Bietet eine Schnittstelle für den Zugriff auf und die Verwaltung von JIRA-Daten über das Model Context Protocol und bietet Funktionen wie Beziehungsverfolgung, Datenbereinigung und kontextbezogene Einblicke für KI-Anwendungen.

  1. Merkmale
    1. Voraussetzungen
      1. Umgebungsvariablen
        1. Installation und Einrichtung
          1. 1. Klonen Sie das Repository:
          2. 2. Installieren Sie Abhängigkeiten und erstellen Sie:
          3. 3. Konfigurieren Sie den MCP-Server:
          4. 4. Starten Sie den MCP-Server neu.
        2. Entwicklung
          1. Verfügbare MCP-Tools
            1. Suchprobleme
            2. hol_epische_Kinder
            3. Problem melden
            4. Problem erstellen
            5. Aktualisierungsproblem
            6. Anhang hinzufügen
            7. Kommentar hinzufügen
          2. Datenbereinigungsfunktionen
            1. Technische Details
              1. Fehlerbehandlung
                1. LIZENZ

                  Related Resources

                  Related MCP Servers

                  • Python Jira MCP Server

                    Chase-Bullock
                    -
                    security
                    F
                    license
                    -
                    quality
                    A server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.
                    Last updated -
                    Python

                  • HH JIRA MCP Server

                    alexeydubinin
                    A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
                    Last updated -
                    3
                    2
                    Python
                    • Apple

                  • JIRA MCP Server for Cursor

                    Dsazz
                    -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server that integrates JIRA directly into Cursor IDE, allowing users to view assigned issues, get detailed information on specific tickets, and convert JIRA issues into local tasks without leaving their editor.
                    Last updated -
                    1
                    TypeScript
                    • Apple

                  • Jira MCP Server

                    maximepeabody
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.
                    Last updated -
                    1
                    Python
                    Apache 2.0

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  ID: q659niazed