XenMCP Docker agent

com.xenmcp由 xenmcp.com 发布v1.0.1更新于 Nov 11, 2026

Read-only MCP server for one Docker host: containers, inspect, logs, stats, events. No exec.

发布方自己的服务:Docker Recipes

概览

AI 生成的概览

面向单台 Docker 主机的只读 MCP 服务器:让助手列出并检查容器、读取日志、查看实时统计和近期事件,不执行命令也不做变更。

可以做什么
  • 查看 Docker 主机信息:版本、操作系统、CPU、内存、容器与镜像数量
  • 列出容器,含名称、镜像、状态、运行时长、端口和 compose 项目
  • 检查容器状态、退出码、OOM 终止、重启次数、健康检查、限制、挂载和网络
  • 按时间窗口读取容器日志,可只取 stdout 或 stderr,支持文本或正则搜索,每次最多 500 行
  • 查看当前 CPU、内存、网络和进程统计,以及最近七天的事件
适用场景
适合让助手排查某个容器为何重启、崩溃或不健康,或查看单台 Docker 主机上的日志与资源占用,同时不赋予其任何变更能力。
运行要求
以容器镜像形式运行在容器旁,需以只读方式挂载 Docker socket 并加入可访问 socket 的用户组。HTTP 模式需要 XENMCP_AGENT_KEY(至少 32 个字符)并以 Authorization Bearer 头发送,还需反向代理提供 HTTPS,并用 XENMCP_ALLOW_IPS 限定调用方。stdio 模式无需密钥和端口。
安装前请注意
日志和检查结果可能包含个人数据和密钥,工具返回的内容会发送到你连接的 AI 客户端。只读挂载 socket 本身并不能阻止写入,真正的限制是该代理自身的允许列表。不通过 XenMCP 时没有按人登录和调用日志,持有密钥者权限相同。不想共享的容器应隐藏。

安装

在 SourceWeft 中

  1. 打开 控制台中的 XenMCP Docker agent,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

XenMCP Docker agent

A small, read-only MCP server for the containers on one Docker host. Run it next to your containers, put it behind your reverse proxy, and connect it to Claude, Cursor or VS Code through XenMCP: every person signs in on their own (OAuth), access can be revoked at any time, and every call is in the journal.

It can see, never change:

ToolWhat it does
docker_infoDocker version, OS, CPUs, memory, number of containers and images
list_containersName, image, state, uptime, ports, compose project
inspect_containerState, exit code, OOM kill, restarts, health check, limits, log driver, mounts, networks — never environment variables or command arguments
container_logsLast lines, a time window (since / until: 15m, 6h, 2d or an ISO time), stdout or stderr only, text or regex search; at most 500 lines per call
container_statsCPU, memory, network, processes right now
recent_eventsstart, stop, die (with exit code), kill, OOM, restart, health status — up to 7 days

There is no tool that starts, stops, restarts, removes, execs, builds or pulls. The agent sends Docker only a short list of GET requests (lib.mjs, allowedPath) and refuses everything else before it leaves the process.

Install

  1. In the XenMCP panel: Add server → Docker agent. It shows a key and the command below with the key filled in.
  2. On your Docker host:
bash
docker run -d --name xenmcp-docker-agent --restart unless-stopped \  --read-only --cap-drop ALL --security-opt no-new-privileges --memory 128m \  --group-add "$(stat -c %g /var/run/docker.sock)" \  -v /var/run/docker.sock:/var/run/docker.sock:ro \  -e XENMCP_AGENT_KEY=<the key from the panel> \  -p 127.0.0.1:8090:8080 \  ghcr.io/xenmcp/docker-agent:1.0
  1. Make it reachable over HTTPS through your reverse proxy (below), e.g. https://docker-agent.example.com/mcp.
  2. In the panel: enter that address and press Check and save.

Or with Docker Compose:

yaml
services:  xenmcp-docker-agent:    image: ghcr.io/xenmcp/docker-agent:1.0    restart: unless-stopped    read_only: true    cap_drop: [ALL]    security_opt: [no-new-privileges:true]    mem_limit: 128m    group_add: ["${DOCKER_GID}"]   # stat -c %g /var/run/docker.sock    volumes:      - /var/run/docker.sock:/var/run/docker.sock:ro    environment:      XENMCP_AGENT_KEY: ${XENMCP_AGENT_KEY}    ports:      - 127.0.0.1:8090:8080

Reverse proxy

The agent listens on plain HTTP; your proxy adds HTTPS. It must pass X-Forwarded-For (all three below do).

Caddy

docker-agent.example.com {  reverse_proxy 127.0.0.1:8090}

nginx

nginx
server {  listen 443 ssl;  server_name docker-agent.example.com;  # ssl_certificate …; ssl_certificate_key …;  location /mcp {    allow 46.225.57.217;   # XenMCP    deny all;    proxy_pass http://127.0.0.1:8090;    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    proxy_buffering off;    proxy_read_timeout 120s;  }}

Traefik (labels on the agent container, without ports)

yaml
labels:  - traefik.enable=true  - traefik.http.routers.xenmcp-agent.rule=Host(`docker-agent.example.com`) && PathPrefix(`/mcp`)  - traefik.http.routers.xenmcp-agent.tls.certresolver=letsencrypt  - traefik.http.services.xenmcp-agent.loadbalancer.server.port=8080

Without XenMCP

The agent is a plain MCP server (Streamable HTTP at /mcp), so any client that can send a header works. Set XENMCP_ALLOW_IPS to the addresses that may call it (* for any, only behind your own proxy or firewall) and send the key as Authorization: Bearer <key>. Without XenMCP there is no per-person sign-in and no journal: everyone with the key has the same access.

Over stdio, for a local client

Started with --stdio, the agent talks MCP over stdin/stdout instead of HTTP: no key, no port, no address list – whoever starts it already has the Docker socket. For Claude Desktop, Cursor or VS Code on the Docker host itself:

json
{  "mcpServers": {    "docker": {      "command": "docker",      "args": ["run", "-i", "--rm", "--no-healthcheck", "--read-only", "--cap-drop", "ALL", "--security-opt", "no-new-privileges",               "--group-add", "<stat -c %g /var/run/docker.sock>",               "-v", "/var/run/docker.sock:/var/run/docker.sock:ro",               "ghcr.io/xenmcp/docker-agent:1.0", "node", "server.mjs", "--stdio"]    }  }}

Or from a checkout: node server.mjs --stdio. The same six read-only tools; XENMCP_CONTAINERS and the xenmcp.hide label apply.

It is listed in the official MCP Registry as com.xenmcp/docker-agent (server.json in this repository).

Settings

VariableDefault
XENMCP_AGENT_KEY—Required over HTTP, at least 32 characters; XenMCP sends it as Authorization: Bearer. Not used with --stdio.
XENMCP_ALLOW_IPS46.225.57.217Who may call, comma-separated, CIDR allowed. Behind a proxy on a private address the last X-Forwarded-For entry counts.
XENMCP_CONTAINERSallOnly these containers, comma-separated, * as wildcard (e.g. shop-*,nginx).
XENMCP_MAX_SCAN_MB200How much log one search or stream filter reads at most.
PORT8080

Hide single containers with the label xenmcp.hide=true: they are left out of every answer.

Good to know

  • Logs are what Docker keeps: with the default json-file driver everything since the container was created, unless you set max-size/max-file. A recreated container starts with an empty log. For history beyond that, use Grafana + Loki.
  • Logs can contain personal data and secrets. What a tool returns goes to the AI client you connect (for Claude: Anthropic). Hide containers you do not want to share.
  • The socket is mounted read-only, but Docker's API does not know read-only mounts — the limit is the agent's own allow-list, which is why it is small, open source and tested (npm test, npm run e2e).

Develop

bash
npm cinpm test        # unit tests and stdio (no Docker needed)npm run e2e     # against your local Docker (starts and removes three busybox containers)

Questions and feedback

Ask in the XenMCP community on Discord (forum #help, tag docker-agent) or open an issue here. Security issues: [email protected], not in public.

MIT licence. Made by Xenaxio for XenMCP.

来源:README.md,提交 6497612

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.1最新Nov 11, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Docker 集成