tiny-loki-mcp

tiny-loki-mcp

tiny-loki-mcp is a small read-only Model Context Protocol server for GrafanaLoki. It exposes a narrow set of tools for agents that need to inspect recentlogs without learning Loki's HTTP API.

Tools

• loki_labels: list available label names.
• loki_label_values: list values for one label.
• loki_query: run a bounded LogQL range query.
• loki_recent: fetch recent logs by optional host and service labels.

All tools are read-only. The server does not expose Loki delete, admin, or pushAPIs.

Configuration

Environment variables:

• LOKI_URL: Loki base URL. Defaults to http://127.0.0.1:3100.
• LOKI_MAX_LIMIT: maximum entries per query. Defaults to 500.
• LOKI_MAX_LOOKBACK_SECONDS: maximum lookback window. Defaults to 86400.
• LOKI_TIMEOUT_MS: HTTP request timeout. Defaults to 10000.

Run

npm install
npm run build
LOKI_URL=http://127.0.0.1:3100 node dist/index.js

MCP Client Example

{
  "mcpServers": {
    "tiny-loki": {
      "command": "node",
      "args": ["/path/to/tiny-loki-mcp/dist/index.js"],
      "env": {
        "LOKI_URL": "http://127.0.0.1:3100"
      }
    }
  }
}

Safety

The server caps query limits and lookback windows. It returns compact recordswith labels, timestamp, and line content instead of raw Loki responses.

Dependency Updates

Dependency updates are managed by Dependabot through .github/dependabot.yml.Dependabot opens weekly grouped PRs for npm and GitHub Actions updates. ThesePRs are never auto-merged; review and run the normal verification path beforemerge.

Releases

Releases use semantic versioning with vMAJOR.MINOR.PATCH tags. Release notesare tracked in CHANGELOG.md. Package publishing is not enabled.

License

MIT