Servidor JIRA MCP para cursor

✨ Características

• Acceda a JIRA directamente desde el cursor

  • Visualiza tus problemas asignados sin salir de tu IDE

  • Obtenga información detallada sobre problemas específicos con un solo comando

  • Convierta problemas de JIRA en tareas locales sin problemas

• ⏰ Integración de la hora del sistema

  • Formato de fecha y hora personalizable

  • Compatibilidad con la configuración regional mediante date-fns

Related MCP server: JIRA MCP Server

🚀 Inicio rápido

Instalación

# Clone the repository
git clone https://github.com/Dsazz/mcp-jira.git
cd mcp-jira

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your JIRA credentials

Configuración

Crea un archivo .env con las siguientes variables:

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

🔑 Nota importante sobre los tokens de API de JIRA

• Los tokens pueden contener caracteres especiales, incluido el signo =

• Coloque el token en una sola línea en el archivo .env

• No agregue comillas alrededor del valor del token

• Pegue el token exactamente como lo proporciona Atlassian

🛠️ Herramientas de desarrollo

Inspector de MCP

El Inspector MCP es una herramienta poderosa para probar y depurar su servidor MCP.

# Run the inspector (no separate build step needed)
npm run inspect

El inspector automáticamente:

• Carga variables de entorno desde .env

• Limpia los puertos ocupados (5175, 3002)

• Construye el proyecto cuando es necesario

• Inicia el servidor MCP con su configuración

• Inicia la interfaz de usuario del inspector

Visita al inspector en http://localhost:5175?proxyPort=3002

Si encuentra conflictos de puertos:

npm run cleanup-ports

Depuración con el Inspector

La interfaz de usuario del inspector le permite:

• Ver todas las capacidades MCP disponibles

• Ejecutar herramientas y examinar respuestas

• Analizar la comunicación JSON

• Prueba con diferentes parámetros

Para obtener más detalles, consulte el repositorio de GitHub de MCP Inspector .

Integración con Claude Desktop

Pruebe su servidor MCP directamente con Claude:

1. Construya y ejecute su servidor:

   npm run build  # You must build the project before running it
   node dist/index.js

2. Configurar Claude Desktop:

   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. Agregue la configuración de MCP:

   {
     "mcpServers": {
       "JIRA Tools": {
         "command": "node",
         "args": ["/absolute/path/to/your/project/dist/index.js"],
         "env": {
           "JIRA_USERNAME": "your-jira-username",
           "JIRA_API_TOKEN": "your-jira-api-token",
           "JIRA_HOST": "your-jira-host.atlassian.net"
         }
       }
     }
   }

4. Reinicie Claude Desktop y pruebe con:

   What time is it right now?

   o

   Show me my assigned JIRA issues.

🔌 Integración con Cursor IDE

⚠️ Importante: Debes compilar el proyecto con npm run build antes de integrarlo con Cursor IDE o Claude Desktop.

Agregue este servidor MCP a la configuración MCP de su Cursor IDE:

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "JIRA_USERNAME": "your-jira-username",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_HOST": "your-jira-host.atlassian.net"
      }
    }
  }
}

🧰 Herramientas disponibles

Herramientas de JIRA

Herramientas de tiempo del sistema

📁 Estructura del proyecto

src/
 ├── features/        # MCP features (JIRA, system time)
 ├── server/          # MCP server implementation
 ├── shared/          # Shared utilities
 └── index.ts         # Main entry point

Scripts de NPM

📘 Recursos

• Documentación del protocolo de contexto del modelo

• SDK de TypeScript para MCP

• Especificación MCP

• Inspector de MCP

📄 Licencia

MIT © Stanislav Stepanenko