oriel — Claude Code MCP server: what it does, how to install
Controls Docker and Colima environments through MCP clients. Masks runtime secrets and blocks destructive actions without explicit approval.
claude mcp add oriel -- docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0What oriel does
This server connects AI assistants to container environments on macOS and Linux. It allows the model to inspect running containers, stream logs, monitor RAM usage, and oversee Compose deployments, images, volumes, and networks. Supported engines include Colima, Docker Engine, OrbStack, Podman, and remote daemons.
Safe read queries run without friction. Destructive commands stay locked behind approval gates, while environment secrets remain concealed from prompts. A working docker CLI alongside a compatible runtime daemon is strictly required, or the server will fail. Memory consumption stays around 15–30 MB when idle.
What it helps with
- inspect running containers and parse crash logs using chat commands
- diagnose exit codes and memory leaks in failing services
- monitor Compose configurations, volumes, and networks
- prune unused container images safely
Example prompts for the agent
- Inspect the api container logs and explain why it restarted
- Show memory consumption across all active Docker containers
- Check our Compose stack status and review mapped ports
How to install oriel
Platform CLI
claude mcp add oriel -- docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0Platform CLI
codex mcp add oriel -- docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0Config file
{
"mcpServers": {
"oriel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/paradoxinfinite/oriel:0.7.0"
]
}
}
}Config file
{
"servers": {
"oriel": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/paradoxinfinite/oriel:0.7.0"
]
}
}
}Platform CLI
gemini mcp add oriel docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about oriel
How to install oriel in Claude Code?
Run claude mcp add oriel -- docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0 in your terminal. This registers the server inside Claude Code via Docker.
What container engines are supported by oriel?
It supports Colima, Docker Engine, OrbStack, Podman, and remote daemons on macOS and Linux. Your environment must have the docker CLI installed.
How does oriel handle security and destructive commands?
Read requests execute directly, while modifying or deleting resources requires an explicit grant. Secret variables are also masked before reaching the model.
