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

# Install the server locally
git clone https://github.com/kallows/mcp-jira-python.git

Related MCP server: Jira MCP Server

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:

%AppData%\\Claude\\claude_desktop_config.json

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:

export JIRA_HOST="your-domain.atlassian.net"
export JIRA_EMAIL="your-email@example.com"
export JIRA_API_TOKEN="your-api-token"

TODO - generar un informe de cobertura de prueba:

Estructura del proyecto

mcp-jira-python/
├── README.md
├── pyproject.toml
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py