Servidor JIRA MCP para cursor

Name: JIRA MCP Server
Author: Dsazz

✨ 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

Related MCP server: MCP Server for Cursor

🚀 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