list_teamsLABSCO SUMMARY
Upstream Grafana, plus SQL on QuestDB and Athena.
If you already know the Grafana MCP server, the reason to pick this fork is narrow and specific: two datasource types the original does not query, and streamable-http as a transport option. Everything else — including the flag-based category disabling that keeps the tool list from swallowing your context — comes along unchanged.
What it is
A fork of the Grafana MCP server. It keeps the upstream surface — dashboards, datasources, Prometheus, Loki, incidents, Sift, OnCall, Pyroscope, alerting — and adds QuestDB and Athena as queryable datasource types, each behind its own enable flag.
What you get
- The fork's additions:
query_questdb_sqlandquery_athena_sql, each executing SQL against that datasource and returning one JSON object per row - Dashboards —
search_dashboards,get_dashboard_by_uid,update_dashboard,get_dashboard_panel_queriesfor pulling every panel's query and datasource - Metrics and logs —
query_prometheus,list_prometheus_metric_names,list_prometheus_label_values,query_loki_logs,query_loki_stats - Incidents and on-call —
list_incidents,create_incident,resolve_incident,list_oncall_schedules,get_current_oncall_users - Sift investigations, including
find_error_pattern_logsandfind_slow_requests - Profiling —
list_pyroscope_profile_types,fetch_pyroscope_profile - Per-category disable flags, so you can drop whole groups you do not use and keep the tool list short
Requirements
A Grafana service account token with the permissions the tools you want will need, passed as GRAFANA_API_KEY alongside GRAFANA_URL. This fork publishes no image or release of its own — the Docker Hub image mcp/grafana and upstream's release binaries are Grafana's and lack the QuestDB and Athena tools — so build the binary (Go 1.24) or the image mcp-grafana:latest from a clone. One catch worth knowing before you configure a client: the image's entrypoint defaults to SSE, so for a stdio client you must pass -t stdio and run the container with -i. Apache licensed.
Setup effort
Run a container — build the image from the repository, then point your client at it
USE CASES
01
Querying a QuestDB or Athena datasource from a chat
Write the SQL, get rows back as JSON objects, without leaving the Grafana datasource configuration you already have.
02
Working out what a dashboard actually measures
Pull every panel's title, query string and datasource in one call instead of clicking through the UI.
03
Triaging an incident from logs
Find elevated error patterns and slow requests, then read the matching Loki streams directly.
39 tools
Listed in project docs. Your client may show a different list.
search_dashboardsget_dashboard_by_uidupdate_dashboardget_dashboard_panel_querieslist_datasourcesget_datasource_by_uidget_datasource_by_namequery_prometheuslist_prometheus_metric_metadatalist_prometheus_metric_nameslist_prometheus_label_nameslist_prometheus_label_valueslist_incidentscreate_incidentadd_activity_to_incidentresolve_incidentquery_loki_logslist_loki_label_nameslist_loki_label_valuesquery_loki_statslist_alert_rulesget_alert_rule_by_uidlist_oncall_schedulesget_oncall_shiftget_current_oncall_userslist_oncall_teamslist_oncall_usersget_investigationget_analysislist_investigationsfind_error_pattern_logsfind_slow_requestslist_pyroscope_label_nameslist_pyroscope_label_valueslist_pyroscope_profile_typesfetch_pyroscope_profilequery_questdb_sqlquery_athena_sqlBEFORE YOU INSTALL
What to know first
Tools you get
39 tools named in the project's documentation.
Requires
- Go 1.24 to build the binary, or Docker to build the image, from a clone of this fork
- A Grafana service account token (GRAFANA_API_KEY) and your Grafana address (GRAFANA_URL)
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/kis9a/mcp-grafana-hyper.git
cd mcp-grafana-hyperBuild the binary (needs Go 1.24) into dist/mcp-grafana:
TERMINAL
make buildOr, for the Docker setups, build the image mcp-grafana:latest instead:
TERMINAL
make build-imageMCP Clients
Claude Desktop — binary
CLAUDE DESKTOP — BINARY · JSON
{
"mcpServers": {
"grafana": {
"command": "<YOUR_PATH_TO_MCP_GRAFANA_HYPER>/dist/mcp-grafana",
"args": [],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_API_KEY": "<YOUR_GRAFANA_API_KEY>"
}
}
}
}<YOUR_PATH_TO_MCP_GRAFANA_HYPER> is the full path of your clone. dist/mcp-grafana is what make build produces.
Claude Desktop — Docker
CLAUDE DESKTOP — DOCKER · JSON
{
"mcpServers": {
"grafana": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"GRAFANA_URL",
"-e",
"GRAFANA_API_KEY",
"mcp-grafana:latest",
"-t",
"stdio"
],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_API_KEY": "<YOUR_GRAFANA_API_KEY>"
}
}
}
}mcp-grafana:latest is the image make build-image creates from this fork; the Docker Hub image mcp/grafana is upstream Grafana's and has no QuestDB or Athena tools. -t stdio overrides the image's default SSE mode.
VS Code — SSE
Start this fork's image in SSE mode (its default) with port 8000 exposed:
VS CODE — SSE · TERMINAL
docker run -it --rm -p 8000:8000 -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_API_KEY=<YOUR_GRAFANA_API_KEY> mcp-grafana:latestVS CODE — SSE · JSON
{
"servers": {
"grafana": {
"type": "sse",
"url": "http://localhost:8000/sse"
}
}
}
