Jira Context MCP

Servidor MCP para proporcionar información de tickets de Jira a agentes de codificación de IA como Cursor.

GitHub
26
Prueba este MCPPatrocinado

Documentación

MseeP.ai Security Assessment Badge

Jira Context MCP

CodeQL Advanced smithery badge Verified on MseeP

Una implementación del Model Context Protocol (MCP) para Jira que te permite:

  • Introducir un enlace de ticket de Jira para obtener los detalles del problema e indicar a Cursor que lo corrija
  • Recuperar todos los tickets asignados a ti dentro de un proyecto de Jira especificado
  • Filtrar problemas de Jira según un tipo de problema específico y dirigir automáticamente a Cursor para resolverlos
  • Integrarse sin problemas con la API de Jira para automatización y eficiencia

Configuración

Requisitos previos

  • Node.js 20.17.0 o superior
  • Una cuenta de Jira con acceso a la API
  • Un token de API de Jira (se puede generar en Atlassian API Tokens)

Instalación

Instalación mediante Smithery

Para instalar Jira Context MCP para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude

Instalación manual

  1. Clona este repositorio:

    git clone https://github.com/yourusername/Jira-Context-MCP.git
cd Jira-Context-MCP

  2. Instala las dependencias:

    npm install
# or if you use pnpm
pnpm install

  3. Crea un archivo .env basado en el ejemplo:

    cp .env.example .env

  4. Edita el archivo .env con los detalles de tu Jira:

    JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-api-token-here
HTTP_PORT=3000

Compilación

Compila el proyecto con:

npm run build
# or
pnpm build

Uso

Iniciar el servidor

Inicia el servidor HTTP:

npm start
# or
pnpm start

O usa el modo CLI:

npm run start:cli
# or
pnpm start:cli

Conectar con Cursor

  1. En Cursor, abre la Paleta de Comandos (Ctrl+Shift+P o Cmd+Shift+P)
  2. Escribe "Connect to MCP Server"
  3. Selecciona "Connect to MCP Server"
  4. Ingresa la URL del servidor (por defecto: http://localhost:3000/sse)

Herramientas disponibles

Una vez conectado, puedes usar las siguientes herramientas en Cursor:

1. Obtener detalles de un problema de Jira

Obtén información detallada sobre un problema específico de Jira:

/get_issue issueKey:PROJECT-123

2. Obtener problemas asignados

Recupera los problemas asignados a ti en un proyecto específico:

/get_assigned_issues projectKey:PROJECT maxResults:10

3. Obtener problemas por tipo

Filtra problemas por tipo (Bug, Historia, Épica, etc.):

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. Obtener proyectos

Lista todos los proyectos disponibles:

/get_projects

5. Obtener tipos de problemas

Lista todos los tipos de problemas disponibles:

/get_issue_types

6. Obtener cambios recientes en tickets

Recupera los cambios realizados en tickets durante un período específico (por ejemplo, los últimos 7 días) en un proyecto:

/get_recent_changes projectKey:PROJECT maxDays:7

Ejemplos de comandos

🚀 ¡Servidor MCP de Jira + IDE Cursor = Tu asistente de Jira con IA! Así es como hace que los desarrolladores trabajen de manera más inteligente:

📂 "Lista todos los proyectos de Jira a los que tengo acceso"
→ La IA obtiene todos los proyectos disponibles al instante
¡No más búsquedas manuales!

📋 "Lista todos los problemas en PROYECTO"
→ La IA recupera todos los tickets abiertos
¡Mantente organizado sin esfuerzo!

🐛 "Filtra solo Bugs o Solicitudes de cambio y corrígelos"
→ La IA identifica y dirige a Cursor para resolverlos
¡Corrige problemas más rápido con automatización!

✅ "Encuentra todos los tickets asignados a mí y corrígelos"
→ La IA extrae tus tareas y deja que Cursor las maneje
¡Mantente al día con tu trabajo sin complicaciones!

🔍 "Obtén detalles del problema de Jira PROYECTO-123"
→ La IA obtiene la información completa del problema en segundos
¡No más cambiar de pestañas!

📊 "¿Qué cambió en los tickets en los últimos 7 días en PROYECTO?"
→ La IA rastrea actualizaciones recientes y resalta cambios clave
¡No más revisar manualmente los historiales de tickets!

🔥 TL;DR: ¡Tu IA ahora habla Jira + Cursor! Obtén proyectos, filtra problemas, rastrea cambios y corrige errores, todo dentro de tu IDE.
Del backlog a la corrección de errores, ¡el Servidor MCP hace que Jira trabaje para ti!

Ejemplos de flujos de trabajo

Corregir un error específico

  1. Conéctate al servidor MCP de Jira en Cursor.
  2. Obtén los detalles del problema: 
    /get_issue issueKey:PROJECT-123
  3. Revisa los detalles del problema e indica a Cursor que lo corrija: 
    Fix the bug described in PROJECT-123

Trabajar en tus problemas asignados

  1. Conéctate al servidor MCP de Jira en Cursor.
  2. Recupera tus problemas asignados: 
    /get_assigned_issues projectKey:PROJECT
  3. Pide a Cursor que te ayude con uno de los problemas: 
    Help me solve the first issue in my assigned list

Corregir todos los errores en un proyecto

  1. Conéctate al servidor MCP de Jira en Cursor.
  2. Recupera todos los problemas de tipo Bug: 
    /get_issues_by_type issueType:Bug projectKey:PROJECT
  3. Indica a Cursor: 
    Help me fix these bugs one by one

Revisar cambios recientes

  1. Conéctate al servidor MCP de Jira en Cursor.
  2. Recupera las actualizaciones recientes de tickets: 
    /get_recent_changes projectKey:PROJECT maxDays:7
  3. Revisa los cambios para mantenerte al día con las modificaciones.

Desarrollo

Estructura del proyecto

  • src/ - Código fuente
    • services/ - Servicio de API de Jira
    • types/ - Definiciones de tipos de TypeScript
    • utils/ - Funciones de utilidad
    • server.ts - Implementación del servidor MCP
    • index.ts - Punto de entrada de la aplicación
    • cli.ts - Punto de entrada de CLI

Añadir nuevas herramientas

Para añadir nuevas herramientas, edita el archivo src/server.ts y agrega nuevas definiciones de herramientas en el método registerTools.

Licencia

MIT

Autor

Rahul Dey - @rahulthedevil