mcp-jira-server

Servidor Jira MCP

Un servidor de protocolo de contexto de modelo que proporciona integración con la API REST de Jira, lo que permite a los asistentes de IA gestionar problemas de Jira mediante programación.

Características

Este servidor proporciona herramientas para gestionar problemas de Jira:

• Crear nuevos problemas (tareas, epopeyas, subtareas)
• Lista de problemas con filtrado de estado opcional
• Actualizar los problemas existentes (resumen, descripción, estado)
• Obtenga información detallada del problema
• Eliminar problemas
• Añadir comentarios a los problemas

Configuración

Prerrequisitos

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

Instalación

1. Instalar dependencias:

2. Construir el servidor:

Configuración

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

2. Configure 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

Herramientas disponibles

crear_problema

Crea un nuevo problema de Jira

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • Resumen: Título del problema
  • Descripción: Descripción del problema
  • tipo: Tipo de problema (Tarea, Épica o Subtarea)

lista_de_problemas

Enumera los problemas del proyecto.

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
• Parámetros opcionales:
  • Estado: Filtrar por estado (p. ej., "Por hacer", "En curso", "Listo")

problema de actualización

Actualiza un problema existente

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de emisión (p. ej., PRJ-123)
• Parámetros opcionales:
  • Resumen: Nuevo título
  • Descripción: Nueva descripción
  • estado: Nuevo estado

obtener_problema

Obtiene información detallada sobre un problema específico

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de emisión (p. ej., PRJ-123)

eliminar_problema

Elimina un problema de Jira

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de emisión (p. ej., PRJ-123)

añadir_comentario

Agrega un comentario a un problema existente

• Parámetros requeridos:
  • working_dir: Directorio que contiene .jira-config.json
  • issue_key: Clave de emisión (p. ej., PRJ-123)
  • comentario: Texto del comentario para agregar

Desarrollo

Para desarrollo con reconstrucción automática:

Manejo de errores

El servidor incluye un manejo integral de errores para:

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

Formato de salida

La información del problema está formateada para incluir:

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