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 tohttp://127.0.0.1:3100.LOKI_MAX_LIMIT: maximum entries per query. Defaults to500.LOKI_MAX_LOOKBACK_SECONDS: maximum lookback window. Defaults to86400.LOKI_TIMEOUT_MS: HTTP request timeout. Defaults to10000.
Run
npm install
npm run build
LOKI_URL=http://127.0.0.1:3100 node dist/index.jsMCP 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
