Servidor JIRA MCP para cursor

✨ Características

Acceda a JIRA directamente desde el cursor
- Visualiza tus problemas asignados sin salir de tu IDE
- Obtenga información detallada sobre problemas específicos con un solo comando
- Convierta problemas de JIRA en tareas locales sin problemas
⏰ Integración de la hora del sistema
- Formato de fecha y hora personalizable
- Compatibilidad con la configuración regional mediante date-fns

🚀 Inicio rápido

Instalación

# Clone the repository
git clone https://github.com/Dsazz/mcp-jira.git
cd mcp-jira

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your JIRA credentials

Configuración

Crea un archivo .env con las siguientes variables:

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

🔑 Nota importante sobre los tokens de API de JIRA
Los tokens pueden contener caracteres especiales, incluido el signo =
Coloque el token en una sola línea en el archivo .env
No agregue comillas alrededor del valor del token
Pegue el token exactamente como lo proporciona Atlassian

🛠️ Herramientas de desarrollo

Inspector de MCP

El Inspector MCP es una herramienta poderosa para probar y depurar su servidor MCP.

# Run the inspector (no separate build step needed)
npm run inspect

El inspector automáticamente:

Carga variables de entorno desde .env
Limpia los puertos ocupados (5175, 3002)
Construye el proyecto cuando es necesario
Inicia el servidor MCP con su configuración
Inicia la interfaz de usuario del inspector

Visita al inspector en http://localhost:5175?proxyPort=3002

Si encuentra conflictos de puertos:

npm run cleanup-ports

Depuración con el Inspector

La interfaz de usuario del inspector le permite:

Ver todas las capacidades MCP disponibles
Ejecutar herramientas y examinar respuestas
Analizar la comunicación JSON
Prueba con diferentes parámetros

Para obtener más detalles, consulte el repositorio de GitHub de MCP Inspector .

Integración con Claude Desktop

Pruebe su servidor MCP directamente con Claude:

Construya y ejecute su servidor:
npm run build # You must build the project before running it node dist/index.js
Configurar Claude Desktop:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
Agregue la configuración de MCP:
{ "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }
Reinicie Claude Desktop y pruebe con:
What time is it right now?
o
Show me my assigned JIRA issues.

🔌 Integración con Cursor IDE

⚠️ Importante: Debes compilar el proyecto con npm run build antes de integrarlo con Cursor IDE o Claude Desktop.

Agregue este servidor MCP a la configuración MCP de su Cursor IDE:

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "JIRA_USERNAME": "your-jira-username",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_HOST": "your-jira-host.atlassian.net"
      }
    }
  }
}

🧰 Herramientas disponibles

Herramientas de JIRA

Herramienta	Descripción	Parámetros	Devoluciones
`jira_get_assigned_issues`	Recupera todos los problemas que te fueron asignados	Ninguno	Lista de problemas en formato Markdown
`jira_get_issue`	Obtiene información detallada sobre un problema específico	`issueKey` : Clave de emisión (p. ej., PD-312)	Detalles del problema en formato Markdown
`jira_create_task`	Crea una tarea local a partir de un problema de JIRA	`issueKey` : Clave de emisión (p. ej., PD-312)	Tarea con formato Markdown

Herramientas de tiempo del sistema

Herramienta	Descripción	Parámetros	Devoluciones
`get_system_time`	Obtiene la hora actual del sistema	`format` : (opcional) cadena de formato date-fns	Cadena de fecha y hora formateada

📁 Estructura del proyecto

src/
 ├── features/        # MCP features (JIRA, system time)
 ├── server/          # MCP server implementation
 ├── shared/          # Shared utilities
 └── index.ts         # Main entry point

Scripts de NPM

Dominio	Descripción
`npm run build`	Construir el proyecto
`npm run publish`	Construir y publicar el paquete en el registro npm
`npm run inspect`	Ejecutar con el inspector MCP para depuración
`npm run cleanup-ports`	Puertos de liberación utilizados por el inspector
`npm test`	Ejecutar pruebas

📘 Recursos

📄 Licencia

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto de modelo que integra JIRA directamente en Cursor IDE, lo que permite a los usuarios ver problemas asignados, obtener información detallada sobre tickets específicos y convertir problemas de JIRA en tareas locales sin salir de su editor.

Related MCP Servers

MCP Atlassian
sooperset
A
security
A
license
A
quality
Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
Last updated -
27
2,005
Python
MIT License
MCP Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
690
1
Python
HH JIRA MCP Server
alexeydubinin
A
security
F
license
A
quality
A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
Last updated -
3
2
Python
JIRA MCP Server
klauseduard
-
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

View all related MCP servers

JIRA MCP Server