Jenkins MCP

Servidor MCP para administrar operaciones de Jenkins.

Instalación

Instalación mediante herrería

Para instalar Jenkins MCP para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude

Instalación manual

uvx install jenkins-mcp

Related MCP server: kom

Configuración

Agregue el servidor MCP utilizando el siguiente fragmento de configuración JSON:

{
  "mcpServers": {
    "jenkins-mcp": {
      "command": "uvx",
      "args": ["jenkins-mcp"],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server/",
        "JENKINS_USERNAME": "your-username",
        "JENKINS_PASSWORD": "your-password",
        "JENKINS_USE_API_TOKEN": "false"
      }
    }
  }
}

Manejo de migajas CSRF

Jenkins implementa la protección CSRF mediante "crumbs", tokens que deben incluirse en las solicitudes POST. Este servidor MCP gestiona las migajas CSRF de dos maneras:

1. Modo predeterminado : obtiene e incluye automáticamente fragmentos CSRF con solicitudes de compilación

   • Utiliza cookies de sesión para mantener la sesión web.

   • Maneja toda la protección CSRF detrás de escena

2. Modo de token de API : utiliza tokens de API de Jenkins que están exentos de la protección CSRF

   • Establezca JENKINS_USE_API_TOKEN=true

   • Establezca JENKINS_PASSWORD en su token de API en lugar de la contraseña

   • Funciona con Jenkins 2.96+, que no requiere migas para la autenticación del token API

Puede generar un token de API en Jenkins en: Usuario → Configurar → Token de API → Agregar nuevo token

Características

• Lista de trabajos de Jenkins

• Desencadenadores de compilaciones con parámetros opcionales

• Comprobar el estado de la compilación

• Manejo de fragmentos CSRF para acceso seguro a la API

Desarrollo

# Install dependencies
uv pip install -r requirements.txt

# Run in dev mode with Inspector
mcp dev jenkins_mcp/server.py