Back to Home
williajm icon

mcp_docker

Verified Safe

by williajm

Overview

Manages Docker containers, images, networks, and volumes for AI assistants via the Model Context Protocol (MCP).

Installation

Run Command
uv run python -m mcp_docker

Environment Variables

  • DOCKER_BASE_URL
  • SAFETY_ALLOW_DESTRUCTIVE_OPERATIONS
  • SECURITY_OAUTH_ENABLED
  • SECURITY_OAUTH_ISSUER (required if SECURITY_OAUTH_ENABLED=true)
  • SECURITY_OAUTH_JWKS_URL (required if SECURITY_OAUTH_ENABLED=true)

Security Notes

The server implements a multi-layered security approach: comprehensive input validation, blocking of dangerous shell commands (e.g., `rm -rf /`, fork bombs, `curl | bash`), environment variable injection protection, sensitive mount path blocking, and error message sanitization to prevent information disclosure. It supports OAuth/OIDC authentication with JWKS caching and introspection, IP filtering (with X-Forwarded-For support), and both pre- and post-authentication rate limiting. Audit logging is robust, structured, and includes automatic redaction of sensitive fields in both arguments and results. The `generate_compose` prompt explicitly redacts environment variable values to prevent credential leakage to LLMs. Strict safety tiers (SAFE, MODERATE, DESTRUCTIVE) with configurable overrides and fine-grained tool/resource filtering are implemented. Continuous fuzzing is integrated to proactively identify vulnerabilities. Explicit warnings are logged for insecure configurations (e.g., HTTP transport on non-localhost, exposed Docker sockets). The primary remaining risk noted in `SECURITY.md` is Retrieval Agent Deception (RADE) where malicious container logs, returned verbatim, could potentially manipulate AI agents, recommending user-side filtering.

Similar Servers

Stats

Interest Score32
Security Score9
Cost ClassLow
Avg Tokens1000
Stars2
Forks0
Last Update2026-01-13

Tags

DockerAIMCPContainer ManagementAPI