# oriel

Controls Docker and Colima environments through MCP clients. Masks runtime secrets and blocks destructive actions without explicit approval.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: ParadoxInfinite
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ParadoxInfinite/oriel
- Updated: 2026-09-07
- HTML: https://affpapa.org/en/nevibecode/mcp/oriel

## What it 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add oriel -- docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0
```

### Codex

**Platform CLI**
```bash
codex mcp add oriel -- docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "oriel": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/paradoxinfinite/oriel:0.7.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "oriel": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/paradoxinfinite/oriel:0.7.0"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add oriel docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0
```

## When to use it
- 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
- 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

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23654
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110

---
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