Skip to main content
Glama
Jira MCP Server for Cursor

Jira MCP Server for Cursor

by kornbed

Servidor Jira MCP para cursor

Un servidor MCP basado en TypeScript que se integra con Jira, lo que permite que Cursor interactúe con los tickets de Jira.

Características

  • Lista de tickets de Jira

  • Obtener detalles de las entradas

  • Obtener comentarios de tickets

  • Crear nuevos tickets

  • Añadir comentarios a los tickets

  • Actualizar el estado del ticket

  • Compatibilidad total con el protocolo MCP para la integración del cursor

Related MCP server: JIRA MCP Server

Configuración

  1. Instalar dependencias:

npm install
  1. Cree un archivo .env basado en .env.example y complete sus credenciales de Jira:

JIRA_HOST=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
PORT=3000

Para obtener su token de API de Jira:

  1. Inicie sesión en https://id.atlassian.com/manage/api-tokens

  2. Haga clic en "Crear token de API".

  3. Copia el token y pégalo en tu archivo .env

Desarrollo

Ejecute el servidor de desarrollo:

npm run dev

Construir y ejecutar

Construir el proyecto:

npm run build

Iniciar el servidor:

npm start

Integración del cursor

Para utilizar este servidor MCP con Cursor, tiene dos opciones:

Opción 1: Integración basada en comandos (recomendada)

  1. Construir el proyecto:

npm run build
  1. Abrir la configuración del cursor:

    • Haga clic en el menú del Cursor

    • Seleccione "Configuración" (o utilice el atajo de teclado)

    • Vaya a la sección "Extensiones" o "Integraciones".

  2. Agregue la configuración de MCP:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-cursor/dist/server.js"]
    }
  }
}

Reemplace /path/to/jira-mcp-cursor con la ruta absoluta a su proyecto.

Opción 2: Integración basada en HTTP (Alternativa)

  1. Inicie el servidor MCP (si aún no está en ejecución):

npm start
  1. Abrir la configuración del cursor:

    • Haga clic en el menú del Cursor

    • Seleccione "Configuración" (o utilice el atajo de teclado)

    • Vaya a la sección "Extensiones" o "Integraciones".

  2. Agregue la configuración de MCP:

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000",
      "capabilities": [
        "list_tickets",
        "get_ticket",
        "get_comments",
        "create_ticket",
        "update_status",
        "add_comment"
      ]
    }
  }
}

Usando Jira en Cursor

Después de configurar el servidor MCP, puedes usar comandos Jira directamente en Cursor:

  • /jira list - Lista tus tickets

  • /jira view TICKET-123 - Ver detalles del ticket

  • /jira comments TICKET-123 - Obtener comentarios del ticket

  • /jira create - Crea un nuevo ticket

  • /jira comment TICKET-123 - Añadir un comentario

  • /jira status TICKET-123 - Actualizar el estado del ticket

Compatibilidad con el protocolo MCP

El servidor implementa el Protocolo Modelo-Cliente (MCP) requerido por Cursor:

  • Comunicación Stdio para integración basada en comandos

  • Registro de herramientas para operaciones de Jira

Puntos finales de API

Lista de entradas

Recupera una lista de tickets de Jira, opcionalmente filtrados por una consulta JQL.

Punto final: GET /api/tickets

Parámetros de consulta:

Parámetro

Tipo

Requerido

Descripción

jql

cadena

No

Cadena de lenguaje de consulta de Jira (JQL) para filtrar tickets

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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

Obtener boleto

Recupera información detallada sobre un ticket específico.

Punto final: GET /api/tickets/:id

Parámetros de ruta:

Parámetro

Tipo

Requerido

Descripción

identificación

cadena

Sí

El ID del ticket de Jira (por ejemplo, TEST-123)

Ejemplo de solicitud:

GET /api/tickets/TEST-123

Ejemplo de respuesta:

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

Obtener comentarios de entradas

Recupera todos los comentarios de un ticket específico.

Punto final: GET /api/tickets/:id/comments

Parámetros de ruta:

Parámetro

Tipo

Requerido

Descripción

identificación

cadena

Sí

El ID del ticket de Jira (por ejemplo, TEST-123)

Ejemplo de solicitud:

GET /api/tickets/TEST-123/comments

Ejemplo de respuesta:

[3/20/2024, 10:00:00 AM] John Doe:
Comment text
---

[3/20/2024, 9:30:00 AM] Jane Smith:
Another comment
---

Crear ticket

Crea un nuevo ticket de Jira.

Punto final: POST /api/tickets

Cuerpo de la solicitud:

Parámetro

Tipo

Requerido

Descripción

resumen

cadena

Sí

El resumen del ticket

descripción

cadena

Sí

La descripción del billete

clave del proyecto

cadena

Sí

La clave del proyecto (por ejemplo, TEST)

tipo de problema

cadena

Sí

El tipo de problema (por ejemplo, tarea, error)

Ejemplo de solicitud:

POST /api/tickets
Content-Type: application/json

{
  "summary": "New feature request",
  "description": "Implement new functionality",
  "projectKey": "TEST",
  "issueType": "Task"
}

Ejemplo de respuesta:

Created ticket: TEST-124

Añadir comentario

Agrega un nuevo comentario a un ticket existente.

Punto final: POST /api/tickets/:id/comments

Parámetros de ruta:

Parámetro

Tipo

Requerido

Descripción

identificación

cadena

Sí

El ID del ticket de Jira (por ejemplo, TEST-123)

Cuerpo de la solicitud:

Parámetro

Tipo

Requerido

Descripción

cuerpo

cadena

Sí

El texto del comentario

Ejemplo de solicitud:

POST /api/tickets/TEST-123/comments
Content-Type: application/json

{
  "body": "This is a new comment"
}

Ejemplo de respuesta:

Added comment to TEST-123

Estado de actualización

Actualiza el estado de un ticket existente.

Punto final: POST /api/tickets/:id/status

Parámetros de ruta:

Parámetro

Tipo

Requerido

Descripción

identificación

cadena

Sí

El ID del ticket de Jira (por ejemplo, TEST-123)

Cuerpo de la solicitud:

Parámetro

Tipo

Requerido

Descripción

ID de transición

cadena

Sí

El ID de la transición a realizar

Ejemplo de solicitud:

POST /api/tickets/TEST-123/status
Content-Type: application/json

{
  "transitionId": "21"
}

Ejemplo de respuesta:

Updated status of TEST-123

Buscar entradas

Busca tickets en proyectos específicos mediante la búsqueda de texto.

Punto final: GET /api/tickets/search

Parámetros de consulta:

Parámetro

Tipo

Requerido

Descripción

buscarTexto

cadena

Sí

Texto a buscar en los tickets

Claves del proyecto

cadena

Sí

Lista separada por comas de claves de proyecto para buscar

resultados máximos

número

No

Número máximo de resultados a devolver (predeterminado: 50)

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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
      -