
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
概览
面向单台 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 模式无需密钥和端口。
安装
在 SourceWeft 中
- 打开 控制台中的 XenMCP Docker agent,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
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:
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
- In the XenMCP panel: Add server → Docker agent. It shows a key and the command below with the key filled in.
- On your Docker host:
- Make it reachable over HTTPS through your reverse proxy (below), e.g.
https://docker-agent.example.com/mcp. - In the panel: enter that address and press Check and save.
Or with Docker Compose:
Reverse proxy
The agent listens on plain HTTP; your proxy adds HTTPS. It must pass X-Forwarded-For (all three below do).
Caddy
nginx
Traefik (labels on the agent container, without ports)
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:
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
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-filedriver everything since the container was created, unless you setmax-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
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.
来源:README.md,提交 6497612
工具
0版本历史
1- v1.0.1最新Nov 11, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Docker 集成
Docker Recipes
recipes.docker官方发布者
一个远程 MCP 服务器,让助手搜索并获取可直接运行、用于自托管和家庭实验室的 Docker Compose 方案。

Reverse Engineer Anything (Docker)
由 GitHub 账号 psyb0t 发布
以 Docker 打包的 REA 逆向工程服务器,让助手反编译 APK、检查二进制文件并通过 adb 操作 Android 设备。

Docker Hub Mcp
由 GitHub 账号 mrfentmen 发布
查询 Docker Hub 上的镜像、标签和拉取次数,让助手无需 API 密钥即可核查容器镜像。

Docker Image Shape
由 GitHub 账号 sadri-dridi 发布
远程 MCP 服务器,提供一组小型、基本无状态的校验工具:Docker 镜像名格式、URL 与主机名解析、HTTP 状态探测、时间与算术。

Docker
由 GitHub 账号 rog0x 发布
本地 MCP 服务器,让助手查看 Docker 容器、镜像与日志,并审查 Dockerfile 和 Compose 文件的最佳实践。