Jira MCP Server

Servidor Jira MCP

Un servidor de protocolo de contexto modelo para Jira.

Proporciona integración con Jira a través de MCP, lo que permite que los LLM interactúen con él.

Documentación de la API REST de Jira

Instalación

Instalación manual

Nota: Requiere que la versión de Node sea 22.12.0 o superior

1. Crear u obtener un token de acceso personal de Jira: Guía
2. Agregar configuración de servidor a Claude Desktop:
   • MacOS: ~/Biblioteca/Soporte de aplicaciones/Claude/claude_desktop_config.json
   • Windows: Consulta esta guía

Para Windows:

Componentes

Herramientas

1. list_projects : enumera proyectos de Jira.
   • Entradas requeridas:
     • query (cadena opcional): una cadena de consulta utilizada para filtrar los proyectos devueltos.
     • maxResults (número opcional, máximo: 100): el número máximo de resultados a devolver.
     • expand (cadena opcional): expande información adicional en la respuesta. ( description separada por comas, lead , issueTypes , url , projectKeys , permissions y insight ).
2. list_boards : Lista los tableros de un proyecto.
   • Entradas requeridas:
     • projectKeyOrId (cadena): clave o Id del proyecto.
     • name (cadena opcional): Nombre del proyecto.
     • maxResults (número opcional, máximo: 100): el número máximo de resultados a devolver.
     • startAt (número opcional): el índice inicial de los tableros devueltos.
     • type (cadena opcional): el tipo de tableros. (puede ser scrum o kanban ).
3. list_sprints_from_board : enumera los sprints de un tablero.
   • Entradas requeridas:
     • boardId (cadena): el ID del tablero.
     • maxResults (número opcional, máximo: 100): el número máximo de resultados a devolver.
     • startAt (número opcional): el índice inicial de los tableros devueltos.
4. list_issues_from_sprint : enumera los problemas de un sprint.
   • Entradas requeridas:
     • boardId (cadena): el ID del tablero.
     • sprintId (cadena): el ID del sprint.
     • maxResults (número opcional, máximo: 100): el número máximo de resultados a devolver.
     • startAt (número opcional): el índice inicial de los tableros devueltos.
     • expand (cadena opcional): expande información adicional en la respuesta. ( schema y names separados por comas).
5. create_issue : crea un problema en Jira (solo admite el tipo de problema de tarea).
   • Entradas requeridas:
     • projectKeyOrId (cadena): clave o Id del proyecto.
     • summary (cadena): el resumen/título del problema.
     • description (cadena): la descripción del problema.

Ejemplos de uso

Algunos ejemplos de indicaciones que puedes usar para interactuar con Jira:

1. "Muéstrame todos los proyectos de Jira" → ejecuta la herramienta list_projects para ver todos los proyectos disponibles.
2. "¿Qué tableros Kanban existen en el proyecto DEV?" → ejecute la herramienta list_boards con la clave del proyecto DEV y el parámetro de tipo establecido en "kanban".
3. "Muéstrame todos los sprints para el tablero ID 123" → ejecuta la herramienta list_sprints_from_board para ver todos los sprints asociados con el tablero 123.
4. "¿Qué problemas hay en el sprint 456 en la placa 123?" → ejecute la herramienta list_issues_from_sprint para ver todos los problemas en el sprint 456 en la placa 123.
5. "Muéstrame los primeros 50 problemas del sprint actual en el tablero de Marketing" → primero ejecuta list_boards para encontrar el ID del tablero de Marketing, luego list_sprints_from_board para encontrar el sprint actual, luego list_issues_from_sprint con maxResults=50.

Desarrollo

1. Instalar dependencias:

2. Configurar el token de acceso de Github en .env :

3. Ejecutar localmente con reloj:

4. Construir el servidor:

5. Depuración local con inspector:

TODOS

• [x] lista_proyectos
• [x] tableros de listas
• [x] lista_sprints_del_tablero
• [x] lista_de_problemas_del_sprint
• [ ] obtener_problema_por_id_o_clave
• [x] create_issue (solo tipo de problema de tarea)
• [ ] create_issue (tipos de problema: historia, épica y subtarea)
• [ ] problema de actualización
• [ ] eliminar_un_problema
• [ ] archivar_un_número
• [ ] lista_de_comentarios_del_problema
• [ ] obtener_comentarios_del_problema_por_id
• [ ] crear_comentario_en_el_tema
• [ ] actualización_del_comentario_del_problema
• [ ] eliminar_comentario_del_problema
• [ ] lista_subtareas_del_problema
• [ ] obtener_usuario_por_nombre_de_usuario_o_clave