Jira

Servidor MCP de Jira

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API REST de Jira usando la librería jira-python. Este servidor se integra con Claude Desktop y otros clientes MCP, permitiéndote interactuar con Jira usando comandos en lenguaje natural.

Características

• Obtener todos los proyectos de Jira accesibles
• Obtener detalles de un problema específico de Jira
• Buscar problemas usando JQL (Lenguaje de Consulta de Jira)
• Crear nuevos problemas de Jira
• Agregar comentarios a problemas
• Obtener transiciones disponibles para un problema
• Transicionar problemas a nuevos estados

Instalación

Requisitos previos

• Python 3.9 o superior
• Una instancia de Jira (Cloud, Server o Data Center)
• uv (opcional pero recomendado para la gestión de dependencias)

Activar un entorno virtual (recomendado)

# Install a Virtual Environment (VENV) in the mcp server directory
python -m venv .
# Activate the virtual environment
source bin/activate

Usando uv (recomendado)

# Install uv if you don't have it
pip install uv

# Install the Jira MCP server
uv pip install mcp-server-jira

Usando pip

pip install mcp-server-jira

Configuración

Variables de entorno

Configura el servidor usando variables de entorno:

• JIRA_SERVER_URL: URL de tu servidor de Jira
• JIRA_AUTH_METHOD: Método de autenticación ('basic_auth' o 'token_auth')
• JIRA_USERNAME: Nombre de usuario para autenticación básica
• JIRA_PASSWORD: Contraseña para autenticación básica
• JIRA_TOKEN: Token de API o Token de Acceso Personal

Archivo de entorno (Desarrollo local)

También puedes crear un archivo .env en el directorio raíz con tu configuración:

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token

Uso

Línea de comandos

python -m mcp_server_jira

Docker

docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

Integración con Claude Desktop

Para usar este servidor con Claude Desktop:

1. Instala el servidor usando uno de los métodos anteriores
2. En Claude Desktop:
   • Ve a Configuración -> Desarrollador
   • Haz clic en Editar Configuración
   • Abre la configuración json en tu editor de preferencia
   • Agrega el siguiente JSON: (NOTE: Las variables de entorno utilizadas son para autenticación por token y no funcionarán con otros métodos de autenticación)

{
  "mcpServers": {
    "jira": {
      "command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv",
      "args": [
          "--directory",
          "<PATH TO JIRA MCP>",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "<USERNAME>",
          "JIRA_TOKEN": "<TOKEN>"
      }
    }
  }
}

3. Ahora puedes interactuar con Jira haciendo preguntas a Claude como:
   • "Muéstrame todos mis proyectos en Jira"
   • "Obtén detalles del problema PROJECT-123"
   • "Crea un nuevo error en el proyecto PROJECT con el resumen 'Corregir problema de inicio de sesión'"
   • "Encuentra todos los errores abiertos asignados a mí"

Autenticación

El servidor soporta múltiples métodos de autenticación:

Autenticación básica

Para Jira Server/Data Center con nombre de usuario y contraseña:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"

Token de API (Jira Cloud)

Para Jira Cloud usando un token de API:

JIRA_SERVER_URL="https://your-domain.atlassian.net"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_email@example.com"
JIRA_TOKEN="your_api_token"

Token de Acceso Personal (Jira Server/Data Center)

Para Jira Server/Data Center (8.14+) usando un PAT:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="token_auth"
JIRA_TOKEN="your_personal_access_token"

Herramientas disponibles

1. get_projects: Obtener todos los proyectos de Jira accesibles
2. get_issue: Obtener detalles de un problema específico de Jira por clave
3. search_issues: Buscar problemas de Jira usando JQL
4. create_issue: Crear un nuevo problema de Jira
5. add_comment: Agregar un comentario a un problema de Jira
6. get_transitions: Obtener transiciones de flujo de trabajo disponibles para un problema de Jira
7. transition_issue: Transicionar un problema de Jira a un nuevo estado

Licencia

MIT