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.

Related MCP server: Jira MCP Server

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

1. Clonar este repositorio:

   git clone https://github.com/yourusername/python-jira-mcp.git
   cd python-jira-mcp

2. Instalar las dependencias:

   pip install -r requirements.txt

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

1. Iniciar el servidor (como se indica arriba)

2. En Cursor, configure la ruta del servidor MCP para que apunte a main.py

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

1. Implementar la función de la herramienta en src/tools/jira_tools.py

2. Agregue el esquema de herramientas en src/tool_schemas.py

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

• Protocolo de contexto modelo

• SDK de Python MCP

• API de Jira de Atlassian