# XenMCP Docker agent

XenMCP Docker agent — an MCP server for Claude Code and Cursor that reads container state and logs via a read-only Docker interface. Runs on the host for infrastructure monitoring through AI clients.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 4 repo stars
- Author: xenMCP
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/xenMCP/docker-agent
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/xenmcp-docker-agent

## What it does

The agent connects to the Docker socket in read-only mode to return system info, container lists, metrics, and event histories without modifying the host. It restricts actions to a fixed set of HTTP GET endpoints and blocks any attempt to start, stop, or execute commands inside containers.

HTTP deployment requires an `XENMCP_AGENT_KEY` of at least 32 characters and a reverse proxy terminating HTTPS. Local usage via `--stdio` bypasses network ports by talking directly over standard input and output while mounting the Docker socket.

Requests over HTTP validate client IPs against `XENMCP_ALLOW_IPS` and log calls to the management panel. Exposing the HTTP port without a firewall or proxy introduces unauthorized access risks.

## Requirements
- Needs: Docker
- Environment variables: `XENMCP_AGENT_KEY`, `XENMCP_ALLOW_IPS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- inspect container resource limits and health checks
- fetch container stdout and stderr logs within a time window
- track container lifecycle events over the last seven days
- check CPU and memory consumption stats for services

## Example prompts
- Show me the current resource usage and stats for all Docker containers
- Fetch the last 200 lines of logs from the web container
- List all running containers and their exposed ports via Docker agent

## Similar
- [containers](https://affpapa.org/en/nevibecode/plugins/containers.md) — plugin · ★ 11 repo stars
- [docker-expert](https://affpapa.org/en/nevibecode/skills/sickn33-docker-expert.md) — skill · 27500 installs
- [docker-patterns](https://affpapa.org/en/nevibecode/skills/docker-patterns.md) — skill · 8600 installs
- [docker-build-strategies](https://affpapa.org/en/nevibecode/skills/docker-build-strategies.md) — skill · 2200 installs
- [docker](https://affpapa.org/en/nevibecode/skills/mindrally-docker.md) — skill · 1200 installs
- [docker-sandboxes-kits](https://affpapa.org/en/nevibecode/skills/docker-sandboxes-kits.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
