Jira MCP Server

Servidor MCP de Jira

Un servidor de Protocolo de Contexto de Modelo que proporciona integración con la API REST de Jira, permitiendo a los asistentes de IA gestionar incidencias de Jira programáticamente.

Características

Este servidor proporciona herramientas para gestionar incidencias de Jira:

• Crear nuevas incidencias (Tareas, Épicas, Subtareas)
• Listar incidencias con filtrado opcional por estado
• Actualizar incidencias existentes (resumen, descripción, estado)
• Obtener información detallada de incidencias
• Eliminar incidencias
• Añadir comentarios a incidencias

Configuración

Requisitos previos

1. Una cuenta de Jira con acceso a la API
2. Token de API de Jira (se puede generar desde Configuración de la cuenta de Atlassian)

Instalación

Instalación mediante Smithery

Para instalar el Servidor de Jira para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install jira-server --client claude

Instalación manual

1. Instalar dependencias:

npm install

2. Compilar el servidor:

npm run build

Configuración

1. Crear un archivo .jira-config.json en su directorio de trabajo:

{
  "projectKey": ["YOUR_PROJECT_KEY", "YOUR_OTHER_PROJECT_KEY"]
}

2. Configurar el servidor MCP con sus credenciales de Jira:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

Herramientas disponibles

create_issue

Crea una nueva incidencia de Jira

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • summary: Título de la incidencia
  • description: Descripción de la incidencia
  • type: Tipo de incidencia (Tarea, Épica o Subtarea)

list_issues

Lista incidencias en el proyecto

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
• Parámetros opcionales:
  • status: Filtrar por estado (por ejemplo, "Por hacer", "En progreso", "Hecho")

update_issue

Actualiza una incidencia existente

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de la incidencia (por ejemplo, PRJ-123)
• Parámetros opcionales:
  • summary: Nuevo título
  • description: Nueva descripción
  • status: Nuevo estado

get_issue

Obtiene información detallada sobre una incidencia específica

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de la incidencia (por ejemplo, PRJ-123)

delete_issue

Elimina una incidencia de Jira

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de la incidencia (por ejemplo, PRJ-123)

add_comment

Añade un comentario a una incidencia existente

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de la incidencia (por ejemplo, PRJ-123)
  • comment: Texto del comentario a añadir

Desarrollo

Para desarrollo con recompilación automática:

npm run watch

Manejo de errores

El servidor incluye manejo integral de errores para:

• Claves de proyecto no válidas
• Configuración faltante
• Tipos de incidencia no válidos
• Errores de autenticación de la API
• Transiciones de estado no válidas

Formato de salida

La información de las incidencias se formatea para incluir:

• Clave y resumen de la incidencia
• Tipo y estado de la incidencia
• Fecha de creación y creador
• Descripción
• Comentarios (si los hay) con autor y marca de tiempo