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 :

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

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:

npm run build
# or
pnpm build

Related MCP server: jira-mcp

Uso

Iniciando el servidor

Iniciar el servidor HTTP:

npm start
# or
pnpm start

O utilice el modo CLI:

npm run start:cli
# or
pnpm start: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:

/get_issue issueKey:PROJECT-123

2. Asignar problemas

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

/get_assigned_issues projectKey:PROJECT maxResults:10

3. Obtener problemas por tipo

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

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. Consigue proyectos

Enumere todos los proyectos disponibles:

/get_projects

5. Obtener tipos de problemas

Enumere todos los tipos de problemas disponibles:

/get_issue_types

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:

/get_recent_changes projectKey:PROJECT maxDays:7

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