Grafana MCP

Read-only project-level Grafana MCP: Loki logs, metrics, traces, alerts, test/prod switching

Connector by itzhouq · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/itzhouq-grafana-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Read-only project-level Grafana MCP: Loki logs, metrics, traces, alerts, test/prod switching

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 3 read · 1 write · 0 delete · 6 not yet classified
Secrets: 2 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Node.js package

Tools by what they do 10

Read from the source code; the running server may list different tools.

Read 3 · Look things up without changing anything.

loki_query
prom_query
tempo_search

Write 1 · Create, change, send or run things.

loki_labels

Not yet classified 6 · We could not tell from the name and description.

alerts
datasources
project_context
prom_instant
switch_environment
tempo_trace

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

GRAFANA_PROD_PASSWORD
GRAFANA_TEST_PASSWORD

Other settings (environment variables or headers).

GRAFANA_APP
GRAFANA_ENV
GRAFANA_PROD_URL
GRAFANA_PROD_USER
GRAFANA_TEST_URL
GRAFANA_TEST_USER

Tools (10)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

alerts
列出当前正在告警的规则（Grafana Alertmanager）。收到 [FIRING:N] 类告警消息后先用它确认现状。
datasources
列出当前 Grafana 实例的全部数据源（类型、名称、UID）。
loki_labels
查询 Loki 标签名或某标签的全部取值。不带 label 参数 → 列出所有标签名；带 label=app → 返回 app 标签的所有取值（用于确认项目 app 名称在当前环境是否存在，防止查错应用）。
loki_query
Description is built at runtime.
project_context
Description is built at runtime.
prom_instant
执行 PromQL 即时查询（单时间点）。示例：kube_pod_container_status_restarts_total{namespace="prod"}
prom_query
执行 PromQL 区间查询。示例：rate(container_cpu_usage_seconds_total{namespace="prod"}[5m])
switch_environment
切换 Grafana 环境（仅影响本会话）。环境信息（连接地址、账密、数据源 UID）来自 ~/.zshrc 解析或配置文件，无需手动 export。切换后返回新环境上下文。
tempo_search
用 TraceQL 搜索链路追踪。示例：{resource.service.name="api" && status=error}
tempo_trace
按 traceID 获取完整链路（span 列表、耗时、状态）。日志中的 traceId=xxx 可直接跟进。

Signals

Stars: 0
Forks: 0
Open issues: 0
Last commit: Oct 9, 2026 (19 days ago)
Last release: Oct 7, 2026 (21 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.itzhouq/grafana-mcp
Version: 0.1.3
Auth: API key
Packages: npm grafana-mcp
License: MIT
Repository: github.com/itzhouq/grafana-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql