Servidor Python Jira MCP

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) en Python que se integra con la API de Jira. Esto permite que los modelos de IA interactúen con Jira mediante un protocolo estandarizado.

Descripción general

Este servidor MCP expone las operaciones de la API de Jira como herramientas que pueden usar los modelos de IA compatibles con el Protocolo de Contexto de Modelo. El servidor implementa el mecanismo de transporte stdio para comunicarse con clientes como Cursor.

Características

Herramienta de búsqueda JQL : busque problemas de Jira mediante consultas JQL
Herramienta para obtener problemas : recupera información detallada sobre un problema específico de Jira
Integración del SDK de MCP : compatible con el SDK oficial de Python de MCP
Modo de respaldo : implementación mínima cuando el SDK no está disponible
Configuración del entorno : Cargar credenciales de Jira desde variables de entorno

Requisitos

Python 3.8+
Acceso a la API de Jira (token de API, correo electrónico y dominio)
Paquetes de Python necesarios:
- mcp (SDK de Python del Protocolo de Contexto de Modelo)
- aiohttp (para solicitudes HTTP)
- pydantic (para validación)
- python-dotenv (para variables de entorno)

Instalación

Clonar este repositorio:
git clone https://github.com/yourusername/python-jira-mcp.git cd python-jira-mcp
Instalar las dependencias:
pip install -r requirements.txt
Configura tus credenciales de Jira:
cp .env.example .env # Edit .env with your Jira credentials

Uso

Ejecución del servidor

Para iniciar el servidor MCP, ejecute:

python main.py

O utilice el ejecutable directamente:

./main.py

El servidor se iniciará y escuchará los mensajes MCP en la entrada estándar (stdin) y responderá en la salida estándar (stdout).

Integración con Cursor

Para utilizar este servidor MCP con Cursor:

Iniciar el servidor (como se indica arriba)
En Cursor, configure la ruta del servidor MCP para que apunte a main.py
Utilice las herramientas de Jira directamente dentro de Cursor

Herramientas disponibles

Búsqueda JQL

Busque problemas de Jira utilizando JQL (lenguaje de consulta de Jira).

Ejemplo:

{
  "type": "tool_call",
  "id": "123",
  "name": "jql_search",
  "parameters": {
    "jql": "project = XYZ AND status = 'In Progress'",
    "max_results": 10,
    "fields": ["summary", "description", "status"]
  }
}

Obtener problema

Recupere detalles sobre un problema específico de Jira por su ID o clave.

Ejemplo:

{
  "type": "tool_call",
  "id": "456",
  "name": "get_issue",
  "parameters": {
    "issue_id_or_key": "XYZ-123",
    "fields": ["summary", "description", "status", "assignee"],
    "expand": "changelog"
  }
}

Desarrollo

Estructura del proyecto

main.py : Punto de entrada para el servidor MCP
src/server.py : Implementación del servidor MCP principal
src/tools/jira_tools.py : Implementaciones de herramientas de API de Jira
src/tool_schemas.py : Definición de esquemas de herramientas

Agregar nuevas herramientas

Para agregar una nueva herramienta relacionada con Jira:

Implementar la función de la herramienta en src/tools/jira_tools.py
Agregue el esquema de herramientas en src/tool_schemas.py
Registra la herramienta en src/server.py

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

Una implementación de servidor que permite que los modelos de IA interactúen con Jira a través del Protocolo de contexto de modelo, lo que habilita tareas como búsquedas JQL y recuperación de detalles de problemas.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Jira MCP Server
uddeshya-23
-
security
F
license
-
quality
Enables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.
Last updated -
2
TypeScript
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
Python
Jira MCP Server
samuelrizzo
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
Last updated -
15
1
TypeScript
MIT License
MCP Server for JIRA
kuvanov-2
A
security
F
license
A
quality
A Model Context Protocol server that enables ChatGPT and other AI assistants to directly interact with JIRA issues, currently offering the ability to retrieve issue details.
Last updated -
TypeScript

View all related MCP servers

Python Jira MCP Server