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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Python Jira MCP Server
Chase-Bullock
-
security
F
license
-
quality
A 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 -
Python
Jira MCP Server
ParasSolanki
A
security
A
license
A
quality
A 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 -
5
87
2
TypeScript
MIT License
Jira MCP Server
maximepeabody
-
security
A
license
-
quality
A 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 -
1
Python
Apache 2.0
Jira MCP Toolset
tbreeding
-
security
A
license
-
quality
A 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 -
177
2
TypeScript
MIT License

View all related MCP servers

JIRA MCP Server