Integrations

Provides system time integration with customizable date and time formatting and locale support.
Allows access to Jira issues directly from the IDE, including viewing assigned issues, getting detailed information on specific issues, and converting Jira issues into local tasks.

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

F

license - not found

-

quality - not tested

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.

JIRA MCP Server for Cursor