Servidor Jira MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API REST de Jira mediante la biblioteca jira-python . Este servidor se integra con Claude Desktop y otros clientes MCP, lo que permite interactuar con Jira mediante comandos de lenguaje natural.

Características

• Obtenga todos los proyectos de Jira accesibles

• Obtener detalles de un problema específico de Jira

• Problemas de búsqueda con JQL (lenguaje de consulta de Jira)

• Crear nuevos problemas de Jira

• Añadir comentarios a los problemas

• Obtener transiciones disponibles para un problema

• Cuestiones de transición hacia nuevos estatus

Related MCP server: JIRA MCP Tools

Instalación

Prerrequisitos

• Python 3.9 o superior

• Una instancia de Jira (nube, servidor o centro de datos)

• 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

Uso de 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

Configurar el servidor usando variables de entorno:

• JIRA_SERVER_URL : URL de su servidor Jira

• JIRA_AUTH_METHOD : Método de autenticación ('basic_auth' o 'token_auth')

• JIRA_USERNAME : Nombre de usuario para la autenticación básica

• JIRA_PASSWORD : Contraseña para autenticación básica

• JIRA_TOKEN : Token de API o token de acceso personal

Expediente Medioambiental (Desarrollo Local)

También puede crear un archivo .env en el directorio raíz con su 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

Estibador

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

Integración de escritorio de Claude

Para utilizar este servidor con Claude Desktop:

1. Instale el servidor utilizando uno de los métodos anteriores

2. En Claude Desktop:

   • Vaya a Configuración -> Desarrollador

   • Haga clic en Editar configuración

   • Abra la configuración json en el editor de su elección

   • Agregue el siguiente JSON: ( NOTE : Las variables de entorno utilizadas son para la autenticación de 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 haciéndole a Claude preguntas como:

   • "Muéstrame todos mis proyectos en Jira"

   • Obtener detalles del problema PROYECTO-123

   • "Crear un nuevo error en el PROYECTO con el resumen 'Solucionar problema de inicio de sesión'"

   • "Buscar todos los errores abiertos que me han sido asignados"

Autenticación

El servidor admite 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 : busca problemas de Jira usando JQL

4. create_issue : Crea un nuevo problema de Jira

5. add_comment : Agregar un comentario a un problema de Jira

6. get_transitions : Obtener las transiciones de flujo de trabajo disponibles para un problema de Jira

7. transition_issue : Transición de un problema de Jira a un nuevo estado

Licencia

Instituto Tecnológico de Massachusetts (MIT)