MCP JIRA Python 🚀

Implementación en Python de un servidor MCP para la integración con JIRA. MCP es un protocolo de comunicación diseñado para proporcionar herramientas a su IA y mantener sus datos seguros (y locales, si lo desea). El servidor se ejecuta en el mismo equipo que su aplicación de IA, y Claude Desktop es la primera aplicación que ejecuta servidores MCP (y se considera un cliente). Consulte la carpeta de ejemplos para ver un cliente MCP simple en Python.

Instalación

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas de integración de JIRA:

• delete_issue : eliminar un problema o subtarea de Jira usando su clave de problema
• create_jira_issue : crea un nuevo problema de Jira con campos personalizables que incluyen resumen, descripción, tipo, prioridad y asignado
• get_issue : recupera detalles completos del problema, incluidos comentarios y archivos adjuntos para una clave de problema determinada
• create_issue_link : crea relaciones entre problemas (por ejemplo, "bloquea", "está bloqueado por", etc.)
• update_issue : Actualiza los problemas existentes con nuevos valores para campos como resumen, descripción, estado, prioridad o asignado
• get_user : busca el ID de la cuenta de un usuario usando su dirección de correo electrónico
• list_fields : obtiene una lista de todos los campos JIRA disponibles y sus propiedades
• list_issue_types : recupera todos los tipos de problemas disponibles en tu instancia de JIRA
• list_link_types : Obtener todos los tipos de relación posibles para la vinculación de problemas
• search_issues : busca problemas utilizando JQL (lenguaje de consulta JIRA) dentro de un proyecto específico
• add_comment : Agregar un comentario de texto a un problema existente
• add_comment_with_attachment : agrega un comentario a un problema con un archivo adjunto

Configuración del escritorio de Claude

Para ello, es necesario actualizar claude_desktop_config.json. La ubicación del archivo varía según Apple, Windows o Linux.

Ventanas

Nota: la ubicación de claude_desktop_config.json en Windows es:

Esto se resolverá (normalmente) en: C:\Users\YOURUSERNAME\AppData\Roaming\Claude

A continuación se muestra el bloque de configuración que se debe agregar a claude_desktop_config.json. En Windows, siempre usamos rutas completas. Actualizará "command", establecerá la ruta de su directorio y agregará la configuración de su entorno JIRA.

☠️ADVERTENCIA: ¡DEBE cerrar Claude Desktop Y matar todos los procesos de Claude para habilitar el claude_desktop_config.json actualizado!😬

Mac y Linux

Actualice la ruta del archivo a mcp-jira-python y complete los valores del entorno JIRA:

Nota:

Debe reiniciar Claude Desktop después de guardar los cambios en claude_desktop_config.json.

Ejecución de herramientas de Python de MCP JIRA

Estas herramientas de MCP se encuentran en el servidor jira-api. Puede ver la lista haciendo clic en el pequeño martillo en la esquina inferior derecha del cuadro de entrada de texto de Claude Desktop. Verifique que las herramientas jira-api estén disponibles en la lista. Para ejecutar una herramienta, simplemente pídale a Claude que realice una tarea de Jira. Cabe destacar que, al principio, Claude podría no ver las herramientas y tener que ser guiado. En algunos casos, se negará a usarlas. Se recomienda actualizar el aviso del sistema.

Ejecución de pruebas

TODO: agregar descripción de la ejecución de las pruebas (unittest) TODO: agregar algo de código para facilitar que las pruebas obtengan las variables de entorno, ya que las pruebas de integración y del sistema requieren las siguientes variables de entorno:

TODO - generar un informe de cobertura de prueba:

Estructura del proyecto