Jira MCP Server for Cursor
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
Instalar dependencias:
npm installCree un archivo
.envbasado en.env.exampley 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=3000Para obtener su token de API de Jira:
Inicie sesión en https://id.atlassian.com/manage/api-tokens
Haga clic en "Crear token de API".
Copia el token y pégalo en tu archivo
.env
Desarrollo
Ejecute el servidor de desarrollo:
npm run devConstruir y ejecutar
Construir el proyecto:
npm run buildIniciar el servidor:
npm startIntegración del cursor
Para utilizar este servidor MCP con Cursor, tiene dos opciones:
Opción 1: Integración basada en comandos (recomendada)
Construir el proyecto:
npm run buildAbrir 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".
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)
Inicie el servidor MCP (si aún no está en ejecución):
npm startAbrir 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".
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=OpenEjemplo 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-123Ejemplo de respuesta:
Key: TEST-123
Summary: Example ticket
Status: Open
Type: Task
Description:
Detailed ticket descriptionObtener 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/commentsEjemplo 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-124Añ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-123Estado 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-123Buscar 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=10Ejemplo 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 toolsadd_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Hosted Airtable MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Opinionated sprint tracker. Read/update tickets, sprints, velocity from Claude/Cursor/Zed.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseBqualityDmaintenanceA TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.1126MIT
- FlicenseNot gradedqualityDmaintenanceA 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.-
- FlicenseNot gradedqualityDmaintenanceModel 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-
- FlicenseAqualityDmaintenanceA 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-