Intégration MCP

DockerSwarm

Dozzle prend en charge le Model Context Protocol (MCP) afin de permettre aux assistants de code IA d'interagir avec vos conteneurs Docker. Une fois activé, Dozzle expose un endpoint MCP sur /api/mcp en utilisant le transport Streamable HTTP, servi depuis le même conteneur : aucun processus ni sidecar supplémentaire n'est nécessaire.

Cette fonctionnalité est désactivée par défaut. Pour l'activer, mettez l'option --enable-mcp ou la variable d'environnement DOZZLE_ENABLE_MCP à true.

cli

docker run --volume=/var/run/docker.sock:/var/run/docker.sock -p 8080:8080 amir20/dozzle --enable-mcp

docker-compose.yml

services:
  dozzle:
    image: amir20/dozzle:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - 8080:8080
    environment:
      DOZZLE_ENABLE_MCP: true

Outils disponibles

Tous les outils sont en lecture seule et ne modifient pas les conteneurs.

Outil	Description
list_containers	Liste tous les conteneurs de tous les hôtes. Accepte un filtre state facultatif.
get_container_logs	Récupère des logs structurés avec détection des niveaux, analyse JSON et regroupement multiligne.
search_container_logs	Recherche un mot-clé ou une phrase dans les logs d'un conteneur. Ne renvoie que les correspondances.
list_hosts	Liste tous les hôtes Docker connectés.
get_container_stats	Récupère l'historique d'utilisation CPU et mémoire d'un conteneur.

Configurer les clients MCP

VS Code (GitHub Copilot / Copilot Chat)

Ajoutez ce qui suit à votre .vscode/mcp.json ou à vos paramètres MCP utilisateur :

{
  "servers": {
    "dozzle": {
      "type": "http",
      "url": "http://localhost:8080/api/mcp"
    }
  }
}

Claude Desktop

Ajoutez ce qui suit à votre configuration MCP de Claude Desktop :

{
  "mcpServers": {
    "dozzle": {
      "type": "streamable-http",
      "url": "http://localhost:8080/api/mcp"
    }
  }
}

NOTE

Remplacez localhost:8080 par l'adresse de votre instance Dozzle. Si Dozzle est configuré avec un chemin de base personnalisé (par ex. --base /dozzle), l'endpoint MCP se trouvera sur /dozzle/api/mcp.

Authentification

L'endpoint MCP fait partie du groupe d'API authentifiées. Lorsque l'authentification est activée, les clients MCP doivent fournir des identifiants valides.

Authentification simple

Avec --auth-provider simple, les clients MCP doivent inclure un jeton JWT valide dans l'en-tête Authorization. Pour obtenir un jeton :

1. Envoyez une requête POST vers /api/token avec votre nom d'utilisateur et votre mot de passe.
2. Configurez votre client MCP pour envoyer le jeton dans un en-tête Bearer.

Par exemple, dans les paramètres MCP de VS Code :

{
  "servers": {
    "dozzle": {
      "type": "http",
      "url": "http://localhost:8080/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-jwt-token>"
      }
    }
  }
}

Authentification par proxy

Avec --auth-provider forward-proxy, le reverse proxy placé devant Dozzle gère l'authentification et injecte les en-têtes appropriés. Les clients MCP doivent se connecter à travers ce même proxy, et l'authentification est alors transparente.

Sans authentification

Sans fournisseur d'authentification configuré (le cas par défaut), l'endpoint MCP est accessible publiquement. Aucune configuration supplémentaire n'est nécessaire.