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

Supports loading Jira credentials from environment variables using python-dotenv for secure configuration.
Integrates with Atlassian's Jira API, enabling AI models to perform Jira operations like searching for issues and retrieving issue details.
Provides tools for searching Jira issues with JQL queries and retrieving detailed information about specific Jira issues, including fields like summary, description, status, and assignee.

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

F

license - not found

-

quality - not tested

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

Python Jira MCP Server