Skip to main content
Glama
deenesjakoruzh

JIRA MCP Server

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

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.

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 .

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

How are these scores calculated?

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. Unterstützung für Jira Cloud und Jira Server (Rechenzentrum).
    1. Merkmale
      1. Voraussetzungen
        1. Umgebungsvariablen
          1. 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.
          2. Entwicklung
            1. Verfügbare MCP-Tools
              1. Suchprobleme
              2. hol\_epische\_Kinder
              3. Problem melden
              4. Problem erstellen
              5. Update-Problem
              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

                    • Jira MCP Server

                      ParasSolanki
                      A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.
                      Last updated -
                      5
                      87
                      2
                      TypeScript
                      MIT License
                      • 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

                    • Jira MCP Toolset

                      tbreeding
                      -
                      security
                      A
                      license
                      -
                      quality
                      A collection of tools for interacting with Jira via the Model Context Protocol, providing core functionalities like fetching and analyzing issues, plus a guided Issue Creation Wizard.
                      Last updated -
                      177
                      2
                      TypeScript
                      MIT License

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/cosmix/jira-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server