Servidor JIRA MCP

Una implementación de servidor de Protocolo de contexto de modelo (MCP) que proporciona acceso a datos de JIRA con seguimiento de relaciones, cargas útiles de datos optimizadas y limpieza de datos para ventanas de contexto de IA.

ℹ️ Hay un servidor MCP separado para Confluence

Soporte de Jira Cloud y Jira Server (centro de datos)

Este servidor MCP admite instancias de Jira Cloud y Jira Server (Data Center) . Puede seleccionar el tipo de instancia configurando la variable de entorno JIRA_TYPE :

• cloud (predeterminado): para Jira Cloud (alojado en Atlassian)

• server : para Jira Server/Data Center (autoalojado)

El servidor utilizará automáticamente la versión de API y el método de autenticación correctos para el tipo seleccionado.

Related MCP server: Jira MCP Server

Características

• Buscar problemas de JIRA usando JQL (máximo 50 resultados por solicitud)

• Recupere hijos épicos con historial de comentarios y cargas útiles optimizadas (máximo 100 problemas por solicitud)

• Obtenga información detallada del problema, incluidos comentarios y problemas relacionados

• Crear, actualizar y gestionar problemas de JIRA

• Añadir comentarios a los problemas

• Extraer menciones de problemas del formato de documento Atlassian

• Realizar un seguimiento de las relaciones entre problemas (menciones, enlaces, padre/hijo, epopeyas)

• Limpie y transforme el contenido enriquecido de JIRA para lograr una mayor eficiencia en el contexto de IA

• Soporte para archivos adjuntos con manejo seguro de carga de varias partes

• Admite las API de Jira Cloud y Jira Server (Data Center)

Prerrequisitos

• Bun (v1.0.0 o superior)

• Cuenta JIRA con acceso a la API

Variables de entorno

JIRA_API_TOKEN=your_api_token
JIRA_BASE_URL=your_jira_instance_url  # e.g., https://your-domain.atlassian.net
JIRA_USER_EMAIL=your_email
JIRA_TYPE=cloud   # or 'server' for Jira Server/Data Center (optional, defaults to 'cloud')

Instalación y configuración

1. Clonar el repositorio:

git clone [repository-url]
cd jira-mcp

2. Instalar dependencias y compilar:

bun install
bun run build

3. Configurar el servidor MCP:

Edite el archivo de configuración apropiado:

macOS:

• Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Escritorio de Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

Ventanas:

• Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

• Escritorio de Claude: %APPDATA%\Claude Desktop\claude_desktop_config.json

Linux:

• Cline: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Claude Desktop: lamentablemente aún no existe

Agregue la siguiente configuración bajo el objeto mcpServers :

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_BASE_URL": "your_jira_instance_url",
        "JIRA_USER_EMAIL": "your_email",
        "JIRA_TYPE": "cloud"
      }
    }
  }
}

4. Reinicie el servidor MCP.

En la configuración de MCP de Cline, reinicie el servidor MCP. Reinicie Claude Desktop para cargar el nuevo servidor MCP.

Desarrollo

Ejecutar pruebas:

bun test

Modo de observación para el desarrollo:

bun run dev

Para reconstruir después de los cambios:

bun run build

Herramientas MCP disponibles

problemas de búsqueda

Busca incidencias de JIRA con JQL. Devuelve hasta 50 resultados por solicitud.

Esquema de entrada:

{
  searchString: string; // JQL search string
}

obtener_niños_épicos

Obtenga todos los problemas de los niños en una épica, incluyendo sus comentarios y datos de relación. Límite de 100 problemas por solicitud.

Esquema de entrada:

{
  epicKey: string; // The key of the epic issue
}

obtener_problema

Obtenga información detallada sobre un problema específico de JIRA, incluidos comentarios y todas las relaciones.

Esquema de entrada:

{
  issueId: string; // The ID or key of the JIRA issue
}

crear_problema

Cree un nuevo problema de JIRA con campos específicos.

Esquema de entrada:

{
  projectKey: string, // The project key where the issue will be created
  issueType: string, // The type of issue (e.g., "Bug", "Story", "Task")
  summary: string, // The issue summary/title
  description?: string, // Optional issue description
  fields?: { // Optional additional fields
    [key: string]: any
  }
}

problema de actualización

Actualizar los campos de un problema de JIRA existente.

Esquema de entrada:

{
  issueKey: string, // The key of the issue to update
  fields: { // Fields to update
    [key: string]: any
  }
}

agregar_adjunto

Agregar un archivo adjunto a un problema de JIRA.

Esquema de entrada:

{
  issueKey: string, // The key of the issue
  fileContent: string, // Base64 encoded file content
  filename: string // Name of the file to be attached
}

añadir_comentario

Añade un comentario a una incidencia de JIRA. Acepta texto sin formato y lo convierte internamente al formato de documento Atlassian requerido.

Esquema de entrada:

{
  issueIdOrKey: string, // The ID or key of the issue to add the comment to
  body: string // The content of the comment (plain text)
}

Funciones de limpieza de datos

• Extrae texto del formato de documento Atlassian

• Los problemas de seguimiento se mencionan en descripciones y comentarios

• Mantiene vínculos formales de problemas con tipos de relación

• Preserva las relaciones entre padres e hijos

• Rastrea asociaciones épicas

• Incluye historial de comentarios con información del autor.

• Elimina metadatos innecesarios de las respuestas

• Procesa recursivamente nodos de contenido para menciones

• Menciones de problemas de deduplicación

Detalles técnicos

• Construido con TypeScript en modo estricto

• Utiliza el tiempo de ejecución de Bun para un mejor rendimiento

• Vite para compilaciones optimizadas

• Utiliza JIRA REST API v3

• Autenticación básica con tokens API

• Solicitudes de API por lotes para datos relacionados

• Cargas útiles de respuesta optimizadas para ventanas de contexto de IA

• Transformación eficiente de estructuras complejas de Atlassian

• Manejo robusto de errores

• Consideraciones sobre la limitación de velocidad

• Límites máximos:

  • Resultados de la búsqueda: 50 números por solicitud

  • Niños épicos: 100 ejemplares por solicitud

• Compatibilidad con datos de formularios multiparte para adjuntar archivos de forma segura

• Detección y validación automática del tipo de contenido

Manejo de errores

El servidor implementa una estrategia integral de manejo de errores:

• Detección de errores de red y mensajería adecuada

• Manejo de códigos de estado HTTP (especialmente 404 para problemas)

• Mensajes de error detallados con códigos de estado

• Detalles del error al registrarse en la consola

• Validación de entrada para todos los parámetros

• Propagación segura de errores mediante el protocolo MCP

• Manejo especializado de errores comunes de la API de JIRA

• Validación Base64 para archivos adjuntos

• Manejo de errores de solicitudes multiparte

• Detección de límite de velocidad

• Validación de parámetros de adjuntos

LICENCIA

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.