Skip to main content
Glama
Jira MCP Server for Cursor

Jira MCP Server for Cursor

by kornbed

Jira MCP Server für Cursor

Schmiedeabzeichen 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

Related MCP server: JIRA MCP Server

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:

Parameter

Typ

Erforderlich

Beschreibung

jql

Schnur

NEIN

Jira 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:

Parameter

Typ

Erforderlich

Beschreibung

Ausweis

Schnur

Ja

Die 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:

Parameter

Typ

Erforderlich

Beschreibung

Ausweis

Schnur

Ja

Die 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:

Parameter

Typ

Erforderlich

Beschreibung

Zusammenfassung

Schnur

Ja

Die Ticketübersicht

Beschreibung

Schnur

Ja

Die Ticketbeschreibung

Projektschlüssel

Schnur

Ja

Der Projektschlüssel (z. B. TEST)

Problemtyp

Schnur

Ja

Die 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:

Parameter

Typ

Erforderlich

Beschreibung

Ausweis

Schnur

Ja

Die Jira-Ticket-ID (z. B. TEST-123)

Anforderungstext:

Parameter

Typ

Erforderlich

Beschreibung

Körper

Schnur

Ja

Der 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:

Parameter

Typ

Erforderlich

Beschreibung

Ausweis

Schnur

Ja

Die Jira-Ticket-ID (z. B. TEST-123)

Anforderungstext:

Parameter

Typ

Erforderlich

Beschreibung

Übergangs-ID

Schnur

Ja

Die 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:

Parameter

Typ

Erforderlich

Beschreibung

Suchtext

Schnur

Ja

In Tickets zu suchender Text

Projektschlüssel

Schnur

Ja

Durch Kommas getrennte Liste der Projektschlüssel, in denen gesucht werden soll

maxErgebnisse

Nummer

NEIN

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

Available Tools

7 tools
add_commentC

Add a comment to a Jira ticket

Inputs: ticketId (required), comment (required).

create_ticketC

Create a new Jira ticket

Inputs: ticket (required).

get_commentsB

Get comments for a specific Jira ticket

Inputs: ticketId (required).

get_ticketC

Get details of a specific Jira ticket

Inputs: ticketId (required).

list_ticketsB

List Jira tickets assigned to you

Inputs: jql.

search_ticketsB

Search for tickets in specific projects using text search

Inputs: searchText (required), projectKeys (required), maxResults.

update_statusB

Update the status of a Jira ticket

Inputs: ticketId (required), status (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific Jira operations: list_tickets vs. search_tickets differentiate between personal assignment and project-wide text search, while get_ticket vs. get_comments separate ticket details from comment retrieval. No tools appear to overlap in functionality, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., add_comment, create_ticket, get_comments). The verbs are appropriately chosen for each action (add, create, get, list, search, update), creating a predictable and readable naming convention throughout the set.

    Tool Count5/5

    With 7 tools, this server is well-scoped for Jira ticket management. Each tool earns its place by covering essential operations like creating, retrieving, listing, searching, updating status, and managing comments, without being overly sparse or bloated for the domain.

    Completeness4/5

    The tool set provides strong coverage for core Jira ticket workflows, including CRUD-like operations (create, get, list, update_status) and comment management. A minor gap exists in the lack of a tool to update ticket details beyond status (e.g., edit description or fields), but agents can work around this by creating new tickets or using comments.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
      11
      26
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol server that allows AI assistants to interact with Jira, supporting operations like creating tickets and fetching project information directly from the cursor.
      1
      -
    • F
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides tools for interacting with Jira. Enables Cursor and other MCP clients to fetch tickets, manage linked tickets, and update ticket status.
      3
      -