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

Related MCP server: JIRA MCP Server

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:

npm install

2. Construir el servidor:

npm run build

Configuración

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

{
  "projectKey": "YOUR_PROJECT_KEY"
}

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

{
  "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

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:

npm run watch

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