# rlg-mcp

An MCP server that hands log files to an AI agent: four tools, one prompt and two resources over stdio. Useful when you debug a failure inside the chat.

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

## What it does

\`rlg-mcp` belongs to the `rlg` ecosystem, a set of Rust crates for structured logging. The server runs over stdio, streamable HTTP or HTTP+SSE and exposes four tools, one prompt and two resources to the agent. Log records arrive as data the agent can query, so you stop pasting file fragments into the chat.

Two ways to get it. Through Cargo: `cargo install rlg-mcp`. Or as the container `ghcr.io/sebastienrousseau/rlg-mcp:0.0.15` — that image is what the install commands for Claude, Codex, Cursor, GitHub Copilot and Gemini CLI reference. Docker has to be on your `PATH`, otherwise the server never starts.

Underneath, `rlg` needs Rust 1.88.0 or newer, edition 2024. The native sinks `os_log` and `journald` exist on macOS and Linux; on Windows and elsewhere records go to a file or stdout. If your service logs through some other library, the server still reads the files, provided the format is one it supports.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add rlg-mcp -- docker run -i --rm ghcr.io/sebastienrousseau/rlg-mcp:0.0.15
```

### Codex

**Platform CLI**
```bash
codex mcp add rlg-mcp -- docker run -i --rm ghcr.io/sebastienrousseau/rlg-mcp:0.0.15
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add rlg-mcp docker run -i --rm ghcr.io/sebastienrousseau/rlg-mcp:0.0.15
```

## When to use it
- trace a service crash from its log file without dumping the whole thing into chat
- pull every error-level record for a given time window
- group messages by component and count the repeats
- strip the noise and keep only records with a specific attribute
- convert a log from one format to another before analysis

## Example prompts
- Connect `rlg-mcp` and list every error in `service.log` from the last hour
- Find records from the `auth-service` component and group them by message
- Read `app.jsonl` through rlg-mcp and tell me what happened before the crash

## Similar
- [logging](https://affpapa.org/en/nevibecode/skills/logging.md) — skill · 2800 installs
- [agent-skills](https://affpapa.org/en/nevibecode/skills/agent-skills.md) — skill · 2600 installs
- [sentry-go-sdk](https://affpapa.org/en/nevibecode/skills/sentry-go-sdk.md) — skill · 2200 installs
- [sentry-instrumentation-guide](https://affpapa.org/en/nevibecode/skills/sentry-instrumentation-guide.md) — skill · 1200 installs
- [logging-best-practices](https://affpapa.org/en/nevibecode/skills/mindrally-logging-best-practices.md) — skill · 791 installs
- [reflex-process-management](https://affpapa.org/en/nevibecode/skills/reflex-process-management.md) — skill · 679 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