MCP 集成

DockerSwarm

Dozzle 支持 Model Context Protocol (MCP)，让 AI 编程助手可以与你的 Docker 容器交互。启用后，Dozzle 会在 /api/mcp 上使用 Streamable HTTP 传输方式提供一个 MCP 端点，由同一个容器提供服务，不需要额外的进程或 sidecar。

该功能默认禁用。要启用它，请把 --enable-mcp 标志或 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

可用工具

所有工具都是只读的，不会修改容器。

工具	说明
list_containers	列出所有主机上的全部容器。支持可选的 state 过滤条件。
get_container_logs	获取结构化日志，包含识别出的级别、JSON 解析和多行分组。
search_container_logs	在容器日志中搜索关键词或短语，只返回匹配的条目。
list_hosts	列出所有已连接的 Docker 主机。
get_container_stats	获取某个容器的 CPU 和内存使用历史。

配置 MCP 客户端

VS Code（GitHub Copilot / Copilot Chat）

把下面的内容加入你的 .vscode/mcp.json 或用户级 MCP 设置：

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

Claude Desktop

把下面的内容加入你的 Claude Desktop MCP 配置：

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

NOTE

请把 localhost:8080 替换为你的 Dozzle 实例地址。如果 Dozzle 配置了自定义基础路径（例如 --base /dozzle），MCP 端点就位于 /dozzle/api/mcp。

身份验证

MCP 端点属于需要身份验证的 API 组。启用身份验证后，MCP 客户端必须提供有效的凭据。

简单身份验证

使用 --auth-provider simple 时，MCP 客户端需要在 Authorization 头中带上有效的 JWT 令牌。获取令牌的方式：

1. 带上用户名和密码，向 /api/token 发送一个 POST 请求。
2. 配置你的 MCP 客户端，把该令牌作为 Bearer 头发送。

例如，在 VS Code 的 MCP 设置中：

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

前置代理身份验证

使用 --auth-provider forward-proxy 时，由 Dozzle 前面的反向代理处理身份验证并注入相应的请求头。MCP 客户端应通过同一个代理连接，身份验证会被透明地处理。

无身份验证

在没有配置身份验证提供方（默认情况）时，MCP 端点是公开可访问的，不需要额外配置。