local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides access to JIRA data including searching issues, retrieving epic children, getting detailed issue information, creating and updating issues, extracting issue mentions, tracking issue relationships, handling file attachments, and transforming JIRA content for AI context windows

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

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

Prerrequisitos

Bun (v1.0.0 o superior)
Cuenta JIRA con acceso a 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

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

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.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Proporciona una interfaz para acceder y administrar datos de JIRA a través del Protocolo de contexto de modelo, ofreciendo funciones como seguimiento de relaciones, limpieza de datos y conocimientos contextuales para aplicaciones de IA.

Related Resources

Reddit Discussion about this server

JIRA MCP Server

Integrations

Servidor JIRA MCP

Características

Prerrequisitos

Variables de entorno

Instalación y configuración

1. Clonar el repositorio:

2. Instalar dependencias y compilar:

3. Configurar el servidor MCP:

4. Reinicie el servidor MCP.

Desarrollo

Herramientas MCP disponibles

problemas de búsqueda

obtener_niños_épicos

obtener_problema

crear_problema

problema de actualización

agregar_adjunto

añadir_comentario

Funciones de limpieza de datos

Detalles técnicos

Manejo de errores

LICENCIA

Related Resources

Appeared in Searches