Skip to main content
Glama

Jira MCP Server for Cursor

Jira MCP Server für Cursor

Ein TypeScript-basierter MCP-Server, der in Jira integriert ist und Cursor die Interaktion mit Jira-Tickets ermöglicht.

Merkmale

  • Auflisten von Jira-Tickets
  • Ticketdetails abrufen
  • Ticketkommentare abrufen
  • Neue Tickets erstellen
  • Kommentare zu Tickets hinzufügen
  • Ticketstatus aktualisieren
  • Vollständige MCP-Protokollunterstützung für die Cursor-Integration

Aufstellen

Installation über Smithery

So installieren Sie den Jira MCP-Server für Cursor für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @kornbed/jira-mcp-server --client claude
  1. Installieren Sie Abhängigkeiten:
npm install
  1. Erstellen Sie eine .env Datei basierend auf .env.example und geben Sie Ihre Jira-Anmeldeinformationen ein:
JIRA_HOST=https://your-domain.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token PORT=3000

So erhalten Sie Ihr Jira-API-Token:

  1. Melden Sie sich bei https://id.atlassian.com/manage/api-tokens an
  2. Klicken Sie auf „API-Token erstellen“.
  3. Kopieren Sie das Token und fügen Sie es in Ihre .env Datei ein

Entwicklung

Führen Sie den Entwicklungsserver aus:

npm run dev

Erstellen und Ausführen

Erstellen Sie das Projekt:

npm run build

Starten Sie den Server:

npm start

Cursor-Integration

Um diesen MCP-Server mit Cursor zu verwenden, haben Sie zwei Möglichkeiten:

Option 1: Befehlsbasierte Integration (empfohlen)

  1. Erstellen Sie das Projekt:
npm run build
  1. Öffnen Sie die Cursor-Einstellungen:
    • Klicken Sie auf das Cursormenü
    • Wählen Sie „Einstellungen“ (oder verwenden Sie die Tastenkombination)
    • Navigieren Sie zum Abschnitt „Erweiterungen“ oder „Integrationen“
  2. Fügen Sie die MCP-Konfiguration hinzu:
{ "mcpServers": { "jira": { "command": "node", "args": ["/path/to/jira-mcp-cursor/dist/server.js"] } } }

Ersetzen Sie /path/to/jira-mcp-cursor durch den absoluten Pfad zu Ihrem Projekt.

Option 2: HTTP-basierte Integration (Alternative)

  1. Starten Sie den MCP-Server (falls er nicht bereits läuft):
npm start
  1. Öffnen Sie die Cursor-Einstellungen:
    • Klicken Sie auf das Cursormenü
    • Wählen Sie „Einstellungen“ (oder verwenden Sie die Tastenkombination)
    • Navigieren Sie zum Abschnitt „Erweiterungen“ oder „Integrationen“
  2. Fügen Sie die MCP-Konfiguration hinzu:
{ "mcpServers": { "jira": { "url": "http://localhost:3000", "capabilities": [ "list_tickets", "get_ticket", "get_comments", "create_ticket", "update_status", "add_comment" ] } } } }

Verwenden von Jira im Cursor

Nach der Konfiguration des MCP-Servers können Sie Jira-Befehle direkt im Cursor verwenden:

  • /jira list – Listen Sie Ihre Tickets auf
  • /jira view TICKET-123 – Ticketdetails anzeigen
  • /jira comments TICKET-123 - Ticketkommentare abrufen
  • /jira create – Ein neues Ticket erstellen
  • /jira comment TICKET-123 – Kommentar hinzufügen
  • /jira status TICKET-123 – Ticketstatus aktualisieren

MCP-Protokollunterstützung

Der Server implementiert das von Cursor benötigte Model-Client-Protocol (MCP):

  • Stdio-Kommunikation für befehlsbasierte Integration
  • Tool-Registrierung für Jira-Operationen

API-Endpunkte

Tickets auflisten

Ruft eine Liste von Jira-Tickets ab, optional gefiltert durch eine JQL-Abfrage.

Endpunkt: GET /api/tickets

Abfrageparameter:

ParameterTypErforderlichBeschreibung
jqlSchnurNEINJira Query Language (JQL)-Zeichenfolge zum Filtern von Tickets

Beispielanfrage:

GET /api/tickets?jql=project=TEST+AND+status=Open

Beispielantwort:

TEST-123: Example ticket (Open) TEST-124: Another ticket (In Progress)

Ticket holen

Ruft detaillierte Informationen zu einem bestimmten Ticket ab.

Endpunkt: GET /api/tickets/:id

Pfadparameter:

ParameterTypErforderlichBeschreibung
AusweisSchnurJaDie Jira-Ticket-ID (z. B. TEST-123)

Beispielanfrage:

GET /api/tickets/TEST-123

Beispielantwort:

Key: TEST-123 Summary: Example ticket Status: Open Type: Task Description: Detailed ticket description

Ticketkommentare abrufen

Ruft alle Kommentare zu einem bestimmten Ticket ab.

Endpunkt: GET /api/tickets/:id/comments

Pfadparameter:

ParameterTypErforderlichBeschreibung
AusweisSchnurJaDie Jira-Ticket-ID (z. B. TEST-123)

Beispielanfrage:

GET /api/tickets/TEST-123/comments

Beispielantwort:

[3/20/2024, 10:00:00 AM] John Doe: Comment text --- [3/20/2024, 9:30:00 AM] Jane Smith: Another comment ---

Ticket erstellen

Erstellt ein neues Jira-Ticket.

Endpunkt: POST /api/tickets

Anforderungstext:

ParameterTypErforderlichBeschreibung
ZusammenfassungSchnurJaDie Ticketübersicht
BeschreibungSchnurJaDie Ticketbeschreibung
ProjektschlüsselSchnurJaDer Projektschlüssel (z. B. TEST)
ProblemtypSchnurJaDie Art des Problems (z. B. Aufgabe, Fehler)

Beispielanfrage:

POST /api/tickets Content-Type: application/json { "summary": "New feature request", "description": "Implement new functionality", "projectKey": "TEST", "issueType": "Task" }

Beispielantwort:

Created ticket: TEST-124

Kommentar hinzufügen

Fügt einem vorhandenen Ticket einen neuen Kommentar hinzu.

Endpunkt: POST /api/tickets/:id/comments

Pfadparameter:

ParameterTypErforderlichBeschreibung
AusweisSchnurJaDie Jira-Ticket-ID (z. B. TEST-123)

Anforderungstext:

ParameterTypErforderlichBeschreibung
KörperSchnurJaDer Kommentartext

Beispielanfrage:

POST /api/tickets/TEST-123/comments Content-Type: application/json { "body": "This is a new comment" }

Beispielantwort:

Added comment to TEST-123

Update-Status

Aktualisiert den Status eines vorhandenen Tickets.

Endpunkt: POST /api/tickets/:id/status

Pfadparameter:

ParameterTypErforderlichBeschreibung
AusweisSchnurJaDie Jira-Ticket-ID (z. B. TEST-123)

Anforderungstext:

ParameterTypErforderlichBeschreibung
Übergangs-IDSchnurJaDie ID des durchzuführenden Übergangs

Beispielanfrage:

POST /api/tickets/TEST-123/status Content-Type: application/json { "transitionId": "21" }

Beispielantwort:

Updated status of TEST-123

Tickets suchen

Sucht mithilfe der Textsuche nach Tickets in angegebenen Projekten.

Endpunkt: GET /api/tickets/search

Abfrageparameter:

ParameterTypErforderlichBeschreibung
SuchtextSchnurJaIn Tickets zu suchender Text
ProjektschlüsselSchnurJaDurch Kommas getrennte Liste der Projektschlüssel, in denen gesucht werden soll
maxErgebnisseNummerNEINMaximale Anzahl der zurückzugebenden Ergebnisse (Standard: 50)

Beispielanfrage:

GET /api/tickets/search?searchText=login+bug&projectKeys=TEST,PROD&maxResults=10

Beispielantwort:

Found 2 tickets matching "login bug" [TEST] TEST-123: Login page bug Status: Open (Updated: 3/20/2024, 10:00:00 AM) Description: Users unable to login using SSO ---------------------------------------- [PROD] PROD-456: Fix login performance Status: In Progress (Updated: 3/19/2024, 3:30:00 PM) Description: Login page taking too long to load ----------------------------------------
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Ein TypeScript-basierter Server, der dem Cursor-Editor die Interaktion mit Jira-Tickets ermöglicht, um Tickets direkt vom Editor aus anzuzeigen, zu erstellen, zu kommentieren und zu aktualisieren.

  1. Merkmale
    1. Aufstellen
      1. Installation über Smithery
    2. Entwicklung
      1. Erstellen und Ausführen
        1. Cursor-Integration
          1. Option 1: Befehlsbasierte Integration (empfohlen)
          2. Option 2: HTTP-basierte Integration (Alternative)
        2. Verwenden von Jira im Cursor
          1. MCP-Protokollunterstützung
            1. API-Endpunkte
              1. Tickets auflisten
              2. Ticket holen
              3. Ticketkommentare abrufen
              4. Ticket erstellen
              5. Kommentar hinzufügen
              6. Update-Status
              7. Tickets suchen

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              MCP server to provide Jira Tickets information to AI coding agents like Cursor
              Last updated -
              152
              4
              TypeScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
              Last updated -
              11
              20
              JavaScript
              MIT License
              • Apple
            • -
              security
              F
              license
              -
              quality
              A TypeScript-based server project that can be integrated with Cursor IDE as an MCP (Model Control Protocol) server, enabling enhanced development capabilities.
              Last updated -
              4
              TypeScript
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.
              Last updated -
              Python
              • Linux
              • Apple

            View all related 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/kornbed/jira-mcp-server'

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