tiny-loki-mcp

tiny-loki-mcp is a small read-only Model Context Protocol server for Grafana Loki. It exposes a narrow set of tools for agents that need to inspect recent logs 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 push APIs.

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 records with 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. These PRs are never auto-merged; review and run the normal verification path before merge.

Releases

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

License

MIT