Jira-Context-MCP

MCP de contexto de Jira

Una implementación del Protocolo de Contexto de Modelo (MCP) para Jira que le permite:

• Ingrese un enlace de ticket de Jira para obtener los detalles del problema e indicarle a Cursor que lo solucione
• Recupere todos los tickets asignados a usted dentro de un proyecto de Jira específico
• Filtra los problemas de Jira según un tipo de problema específico y dirige automáticamente Cursor para resolverlos
• Integre perfectamente con la API de Jira para automatización y eficiencia

Configuración

Prerrequisitos

• 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 herrería

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

Instalación manual

1. Clonar este repositorio:
   git clone https://github.com/yourusername/Jira-Context-MCP.git cd Jira-Context-MCP
2. Instalar dependencias:
   npm install # or if you use pnpm pnpm install
3. Cree un archivo .env basado en el ejemplo:
   cp .env.example .env
4. Edite el archivo .env con sus detalles de 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

Construir

Construya el proyecto con:

Uso

Iniciando el servidor

Iniciar el servidor HTTP:

O utilice el modo CLI:

Conectando con el cursor

1. En Cursor, abra la Paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P)
2. Escriba "Conectarse al servidor MCP"
3. Seleccione "Conectarse al servidor MCP"
4. Introduzca la URL del servidor (predeterminado: http://localhost:3000/sse )

Herramientas disponibles

Una vez conectado, podrá utilizar las siguientes herramientas en Cursor:

1. Obtener detalles del problema de Jira

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

2. Asignar problemas

Recuperar problemas asignados a usted en un proyecto específico:

3. Obtener problemas por tipo

Filtrar problemas por tipo (error, historia, épico, etc.):

4. Consigue proyectos

Enumere todos los proyectos disponibles:

5. Obtener tipos de problemas

Enumere todos los tipos de problemas disponibles:

6. Obtenga cambios recientes de tickets

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

Ejemplos de comandos

🚀 Jira MCP Server + Cursor IDE = ¡Tu asistente Jira con IA! Así es como facilita el trabajo de los desarrolladores:

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

📋 "Enumerar todos los problemas en PROYECTO"
→ La IA recupera todos los tickets abiertos
¡Manténgase organizado sin esfuerzo!

🐛 "Filtrar solo errores o solicitudes de cambio y solucionarlos"
→ La IA identifica y dirige al cursor para resolverlos
¡Solucione problemas más rápido con la automatización!

✅ "Encuentra todos los tickets que tengo asignados y corrígelos"
→ La IA extrae tus tareas y deja que Cursor las gestione
¡Manténgase al tanto de su trabajo sin complicaciones!

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

📊 "¿Qué cambió en los tickets en los últimos 7 días en PROYECTO?"
→ La IA rastrea las actualizaciones recientes y destaca los cambios clave
¡Ya no es necesario verificar manualmente el historial de tickets!

🔥 TL;DR: ¡ Tu IA ahora habla Jira + Cursor! Recupera proyectos, filtra incidencias, rastrea cambios y corrige errores, todo desde tu IDE.
Desde el trabajo atrasado hasta la corrección de errores, ¡MCP Server hace que Jira trabaje para usted!

Flujos de trabajo de ejemplo

Corregir un error específico

1. Conéctese al servidor Jira MCP en Cursor.
2. Obtenga los detalles del problema:
   /get_issue issueKey:PROJECT-123
3. Revise los detalles del problema e indique a Cursor que lo solucione:
   Fix the bug described in PROJECT-123

Trabaje en los problemas asignados

1. Conéctese al servidor Jira MCP en Cursor.
2. Recupera tus problemas asignados:
   /get_assigned_issues projectKey:PROJECT
3. Pídale a Cursor que le 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éctese al servidor Jira MCP en Cursor.
2. Recuperar todos los problemas de errores:
   /get_issues_by_type issueType:Bug projectKey:PROJECT
3. Instruir cursor:
   Help me fix these bugs one by one

Revisar cambios recientes

1. Conéctese al servidor Jira MCP en Cursor.
2. Recuperar actualizaciones de tickets recientes:
   /get_recent_changes projectKey:PROJECT maxDays:7
3. Revise los cambios para mantenerse actualizado sobre las modificaciones.

Desarrollo

Estructura del proyecto

• src/ - Código fuente
  • services/ - Servicio 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 CLI

Agregar nuevas herramientas

Para agregar nuevas herramientas, edite el archivo src/server.ts y agregue nuevas definiciones de herramientas en el método registerTools .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Autor

Rahul Dey - @rahulthedevil