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

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

Para Windows:

{
  "mcpServers": {
    "jira": {
      "command": "cmd /c npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

Related MCP server: Jira MCP Server

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:

pnpm install

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

JIRA_PERSONAL_ACCESS_TOKEN=email@example.com:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url

3. Ejecutar localmente con reloj:

pnpm dev

4. Construir el servidor:

pnpm build

5. Depuración local con inspector:

pnpm 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