Skip to main content
Glama
enesjakozh

JIRA MCP Server

by klauseduard
GitHub
Python
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

graph LR A[Start Search] -->|Enter JQL| B[Search Query] B -->|Apply Filters| C[Results] C -->|Select Fields| D[Customized View] D -->|Pagination| E[More Results] subgraph Search Options F[JQL Query] G[Field Selection] H[Result Limit] I[Start Position] end B -->|Uses| F C -->|Uses| G C -->|Uses| H C -->|Uses| I

Flujo de clonación de problemas

graph LR A[Find Source Issue] -->|Copy Key| B[Clone Issue] B -->|Customize Fields| C[Modified Clone] C -->|Create| D[New Issue] subgraph Clone Options E[Change Project] F[Modify Fields] G[Copy Attachments] H[Add Source Link] end B -->|Can Use| E B -->|Can Use| F B -->|Can Use| G B -->|Can Use| H

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

  1. Crear un entorno virtual:

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

  1. Instalar dependencias:

pip install -r requirements.txt

  1. 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

  1. 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

  2. Núcleo ( src/core/ )

    • JiraClient - Cliente API principal de JIRA

    • JiraConfig - Gestión de configuración

    • Manejo y registro de errores

  3. 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

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:

  1. Su instancia de JIRA usa HTTPS

  2. Estás utilizando tokens API (no contraseñas) para la autenticación

  3. Su archivo .env está protegido adecuadamente y no está comprometido con el control de versiones

  4. Comprende los riesgos de ejecutar herramientas de terceros con acceso a JIRA

🛡️ Mejores prácticas

  1. Rota periódicamente tus tokens API

  2. Supervise sus registros de auditoría de JIRA para detectar actividad inesperada

  3. Utilice la versión más reciente de la herramienta

  4. 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

How are these scores calculated?

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.

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.

  1. Características
    1. Flujos de trabajo de usuario
      1. Flujo de búsqueda y filtrado
      2. Flujo de clonación de problemas
    2. Acerca de MCP
      1. Configuración
        1. Uso
          1. Desarrollo
            1. Componentes clave
          2. Enlaces relacionados
            1. Licencia
              1. Consideraciones de seguridad
                1. ⚠️ Recomendaciones de uso
                2. 🔒 Requisitos de seguridad
                3. 🛡️ Mejores prácticas
                4. 📝 Nota sobre el uso empresarial

              Related MCP Servers

              • MCP Server for Cursor

                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.

              • Cursor DB MCP Server

                jbdamask
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.
                Last updated -
                21
                • Apple

              • HH JIRA MCP Server

                alexeydubinin
                A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
                Last updated -
                3
                2
                • Apple

              • Jira MCP Server

                InfinitIQ-Tech
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.
                Last updated -
                10
                1
                MIT License

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/klauseduard/vibe-coded-jira-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server