Jenkins MCP

Un servidor MCP basado en la API REST de Jenkins, cuyo objetivo es ser compatible con Jenkins 2.332.2, 2.356 y versiones posteriores.

No instala plugins de Jenkins, por lo que no está limitado por la versión mínima del núcleo de Jenkins del plugin oficial mcp-server. Un servidor MCP puede gestionar múltiples instancias de Jenkins en la configuración y seleccionar la instancia de destino mediante jenkins_name.

Capacidades implementadas

• Consultar la versión de Jenkins y las capacidades de compatibilidad

• Consultar el usuario autenticado actual

• Consultar trabajos (Jobs) en el directorio raíz o en una carpeta (Folder)

• Consultar Jobs y Builds

• Obtener registros de compilación (build logs) y limitar el número de líneas devueltas

• Consultar Queue, Queue Item y nodos

• Disparar builds, detener builds y cancelar builds en cola

• Autenticación con nombre de usuario + API Token

• Obtener y reintentar automáticamente el CSRF Crumb de Jenkins

• Solo lectura por defecto; las operaciones de escritura requieren establecer explícitamente read_only: false

Related MCP server: Jenkins MCP Server

Instalación

Se recomienda usar Python 3.10 o superior:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e '.[dev]'

Configuración de múltiples Jenkins

Crea jenkins-mcp.json:

{
  "instances": [
    {
      "name": "jenkins-233",
      "base_url": "https://jenkins-233.example.com",
      "username": "mcp-user",
      "api_token": "replace-me",
      "read_only": true,
      "verify_ssl": true,
      "timeout_seconds": 30,
      "max_log_lines": 2000
    },
    {
      "name": "jenkins-356",
      "base_url": "https://jenkins-356.example.com/jenkins",
      "username": "mcp-user",
      "api_token": "replace-me",
      "read_only": false
    }
  ],
  "server": {
    "transport": "stdio",
    "log_level": "INFO"
  }
}

Inicia:

jenkins-mcp --config jenkins-mcp.json

En producción, se recomienda inyectar la configuración mediante variables de entorno o un sistema de gestión de secretos; no hagas commit del API Token en Git.

Configuración de un solo Jenkins mediante variables de entorno

También se pueden usar las siguientes variables:

export JENKINS_URL='https://jenkins.example.com'
export JENKINS_USERNAME='mcp-user'
export JENKINS_API_TOKEN='replace-me'
export JENKINS_READ_ONLY='true'
jenkins-mcp

Para múltiples instancias, puedes colocar un array JSON en JENKINS_INSTANCES_JSON, o usar JENKINS_CONFIG_FILE para apuntar a un archivo de configuración JSON.

Configuración del cliente MCP

Ejemplo con stdio:

{
  "mcpServers": {
    "jenkins": {
      "command": "/absolute/path/to/.venv/bin/jenkins-mcp",
      "args": ["--config", "/absolute/path/to/jenkins-mcp.json"]
    }
  }
}

Al invocar herramientas, usa jenkins_name, por ejemplo:

list_jobs(jenkins_name="jenkins-233")
get_build_log(jenkins_name="jenkins-356", job_name="team/app", build_number=123)

Estrategia de compatibilidad de versiones

El servicio detecta la versión mediante la cabecera de respuesta X-Jenkins de Jenkins. 2.332.2 es la línea base mínima de compatibilidad actual, y 2.356 usa las mismas capacidades básicas de la API REST. Las diferencias relacionadas con la versión se colocan en el modelo de capacidades de versioning.py; la capa de herramientas MCP no realiza comprobaciones de versión directamente.

La API REST básica es más adecuada que la API de plugins de Jenkins para su uso entre versiones, pero las funciones específicas de plugins, la información avanzada de Pipeline y la gestión de credenciales no forman parte de la garantía de compatibilidad entre versiones actual.

Desarrollo

pytest
ruff check .