-
security-
license-
qualityA server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.
Last updated -
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.
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.jsonEscritorio de Claude:
~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas:
Cline:
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.jsonEscritorio de Claude:
%APPDATA%\Claude Desktop\claude_desktop_config.json
Linux:
Cline:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonClaude 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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
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.
- Soporte de Jira Cloud y Jira Server (centro de datos)
- Características
- Prerrequisitos
- Variables de entorno
- Instalación y configuración
- Desarrollo
- Herramientas MCP disponibles
- Funciones de limpieza de datos
- Detalles técnicos
- Manejo de errores
- LICENCIA
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.Last updated -5172MIT License
- -security-license-qualityA Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.Last updated -1Apache 2.0
- -security-license-qualityA collection of tools for interacting with Jira via the Model Context Protocol, providing core functionalities like fetching and analyzing issues, plus a guided Issue Creation Wizard.Last updated -522MIT License