remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables retrieving and searching JIRA issues using JQL (JIRA Query Language), with support for configurable field selection, pagination, and logging work on issues.

Servidor JIRA MCP

Un servidor simple con Protocolo de Contexto de Modelo (MCP) "codificado por vibración" para integrar JIRA con Cursor IDE. MCP es un protocolo abierto que permite una integración fluida entre aplicaciones LLM y fuentes de datos y herramientas externas.

Esta implementación comenzó descartando otro servidor JIRA MCP que no pudimos inicializar en Cursor.

¡ATENCIÓN! Este documento está escrito casi en su totalidad por un asistente de codificación de IA.

Características

Obtener problemas de JIRA por clave
Problemas de búsqueda mediante JQL (lenguaje de consulta JIRA)
Crear y actualizar problemas (nota: puede tener limitaciones con proyectos JIRA muy personalizados)
Añadir comentarios a los problemas
Problemas de clonación (útiles para solucionar campos personalizados obligatorios, pero pueden tener limitaciones con configuraciones de proyectos complejas)
Selección de campo configurable
Soporte de paginación
Manejo y registro detallado de errores
Trabajo de registro

Flujos de trabajo de usuario

Flujo de búsqueda y filtrado

Flujo de clonación de problemas

Para conocer la arquitectura técnica detallada y los flujos de trabajo del sistema, incluidos el ciclo de vida de los problemas y los flujos de autenticación, consulte ARCHITECTURE.md .

Acerca de MCP

Este servidor implementa la especificación del Protocolo de Contexto de Modelo , lo que permite que Cursor IDE interactúe fluidamente con los datos de JIRA mediante sus funciones de IA. El protocolo estandariza la comunicación de las aplicaciones LLM con fuentes de datos y herramientas externas.

Configuración

Crear un entorno virtual:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Instalar dependencias:

pip install -r requirements.txt

Configurar variables de entorno: Cree un archivo .env con:

JIRA_URL=your_jira_url
JIRA_USERNAME=your_username
JIRA_API_TOKEN=your_api_token

Uso

Ejecutar el servidor:

./run-jira-mcp.sh

Desarrollo

El proyecto sigue una estructura modular:

src/
├── core/           # Core JIRA client implementation
│   ├── __init__.py
│   ├── client.py   # JiraClient class
│   └── config.py   # Configuration management
├── models/         # Pydantic models for validation
│   ├── __init__.py
│   ├── comment.py  # Comment-related models
│   ├── issue.py    # Issue-related models
│   └── worklog.py  # Worklog-related models
└── operations/     # MCP operation implementations
    ├── __init__.py
    ├── comments.py # Comment operations
    ├── issues.py   # Issue operations
    ├── projects.py # Project operations
    └── worklog.py  # Worklog operations

Componentes clave

Modelos ( src/models/ )
- IssueType , IssueArgs : modelos de creación y actualización de problemas
- IssueTransitionArgs - Modelo de transición de estados de problemas
- CloneIssueArgs : modelo de clonación de problemas
- CommentArgs , GetCommentsArgs - Modelos de comentarios
- LogWorkArgs - Modelo de registro de trabajo
Núcleo ( src/core/ )
- JiraClient - Cliente API principal de JIRA
- JiraConfig - Gestión de configuración
- Manejo y registro de errores
Operaciones ( src/operations/ )
- Gestión de problemas (obtener, buscar, crear, actualizar, clonar)
- Manejo de comentarios (agregar, obtener)
- Registro de trabajo
- Listado de proyectos

El proyecto sigue el plan de implementación descrito en IMPLEMENTATION_PLAN.md .

Versión actual: v0.4

✅ Integración básica con JIRA
✅ Funcionalidad de búsqueda con soporte JQL
✅ Gestión de problemas (crear, actualizar, clonar) con limitaciones para proyectos muy personalizados
✅ Funcionalidad de comentarios
✅ Registro de trabajo

Enlaces relacionados

Protocolo de Contexto Modelo - El proyecto principal de MCP
MCP Python SDK : el SDK que usamos para implementar este servidor
Documentación de MCP : documentación y especificaciones del protocolo

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Consideraciones de seguridad

Esta herramienta está diseñada principalmente para la automatización de flujos de trabajo personales y el uso individual por parte de desarrolladores. Tenga en cuenta las siguientes consideraciones de seguridad:

⚠️ Recomendaciones de uso

Uso personal/de desarrollo : ideal para desarrolladores individuales que administran sus flujos de trabajo de JIRA
Uso en equipos pequeños : adecuado para entornos de equipos confiables con medidas de seguridad adecuadas
NO recomendado para :
- Despliegue de producción en su forma actual
- Entornos multiinquilino
- Servicios de atención al público
- Tratamiento de datos sensibles/regulados

🔒 Requisitos de seguridad

Si decide utilizar esta herramienta, asegúrese de lo siguiente:

Su instancia de JIRA usa HTTPS
Estás utilizando tokens API (no contraseñas) para la autenticación
Su archivo .env está protegido adecuadamente y no está comprometido con el control de versiones
Comprende los riesgos de ejecutar herramientas de terceros con acceso a JIRA

🛡️ Mejores prácticas

Rota periódicamente tus tokens API
Supervise sus registros de auditoría de JIRA para detectar actividad inesperada
Utilice la versión más reciente de la herramienta
Revise el código antes de usarlo en su entorno

📝 Nota sobre el uso empresarial

Esta herramienta no está actualmente reforzada para los requisitos de seguridad empresarial. Si necesita una solución para la implementación empresarial, considere:

Implementación de controles de seguridad adicionales
Realizar una revisión de seguridad
Aportando mejoras de seguridad al proyecto
Uso de alternativas oficiales de nivel empresarial

Para inquietudes relacionadas con la seguridad o para informar vulnerabilidades, abra un problema o comuníquese directamente con los mantenedores.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite una integración perfecta entre Cursor IDE y JIRA, lo que permite a los usuarios recuperar problemas, ejecutar búsquedas JQL y registrar el trabajo a través de interacciones en lenguaje natural.

JIRA MCP Server