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

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

2. 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

2. Ö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“

3. 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

2. Ö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“

3. 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:

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:

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:

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:

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:

Anforderungstext:

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:

Anforderungstext:

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:

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