Servidor JIRA MCP

Un servidor MCP que permite que los Modelos de Lenguaje Grandes (LLM) interactúen con JIRA mediante herramientas y contexto estandarizados. Este servidor ofrece funciones para buscar incidencias mediante JQL y recuperar información detallada sobre ellas.

Características

• Búsqueda JQL : Ejecute consultas JQL complejas con soporte de paginación

• Detalles del problema : recupera información detallada sobre problemas específicos de JIRA

Related MCP server: Python Jira MCP Server

Prerrequisitos

• npm instalado

• Una instancia de JIRA con acceso a API

• Token de API de JIRA o token de acceso personal

• Correo electrónico del usuario de JIRA asociado con el token de API

Obtención de credenciales de API de JIRA

1. Inicie sesión en su cuenta de Atlassian en https://id.atlassian.com

2. Vaya a Configuración de seguridad

3. En Tokens de API, seleccione "Crear token de API".

4. Dale a tu token un nombre significativo (por ejemplo, "Servidor MCP")

5. Copia el token generado: ¡no podrás volver a verlo!

6. Utilice este token como su JIRA_API_KEY

7. Utilice la dirección de correo electrónico asociada a su cuenta Atlassian como JIRA_USER_EMAIL

Uso

Integración con Claude Desktop

1. Agregue la configuración del servidor al archivo de configuración de Claude Desktop:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

2. Reinicie Claude Desktop para cargar la nueva configuración.

Herramientas disponibles

1. Búsqueda JQL ( jql_search )

Ejecuta una consulta de búsqueda JQL con parámetros personalizables.

Parámetros :

• jql (obligatorio): cadena de consulta JQL

• nextPageToken : Token para paginación

• maxResults : Número máximo de resultados a devolver

• fields : Matriz de nombres de campos a incluir

• expand : Información adicional para incluir

Ejemplo :

2. Obtener problema ( get_issue )

Recupera información detallada sobre un problema específico.

Parámetros :

• issueIdOrKey (obligatorio): ID del problema o clave

• fields : Matriz de nombres de campos a incluir

• expand : Información adicional para incluir

• properties : Matriz de propiedades a incluir

• failFast : si se debe fallar rápidamente ante errores

Ejemplo :

Desarrollo

Configuración

Configure las variables de entorno antes de ejecutar el servidor. Cree un archivo .env en el directorio raíz:

Reemplace los valores con:

• La URL real de su instancia de JIRA

• La dirección de correo electrónico asociada a su cuenta de JIRA

• Su token de API de JIRA (se puede generar en la configuración de la cuenta de Atlassian)

Instalación

Instalación mediante herrería

Para instalar JIRA para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Clonar este repositorio:

2. Instalar dependencias:

Ejecutando con MCP Inspector

Para pruebas y desarrollo, puede utilizar el Inspector MCP:

Agregar nuevas herramientas

Para agregar nuevas herramientas, modifique el controlador ListToolsRequestSchema en index.js :

Luego implemente la herramienta en el controlador CallToolRequestSchema .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar un PR.