---
title: "Grafana UI component MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/grafana-ui-mcp/
description: "A stdio server that reads Grafana UI component source, stories, and docs with GitHub GET or a local checkout."
---

# Grafana UI component MCP: review, setup & limitations · Undominated.ai

> A stdio server that reads Grafana UI component source, stories, and docs with GitHub GET or a local checkout.

[← Explore all mcp servers](/mcp-servers/)

COMPONENT REFERENCE / Miguel Palau

# Grafana UI component MCP

A stdio server that reads Grafana UI component source, stories, and docs with GitHub GET or a local checkout.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/grafana/grafana-ui-mcp-server/tree/36124c7690b7e9e6979afa1976f75807cf7faeff)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 5 linked sources
 Publisher Miguel Palau
 Licence [MIT ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/LICENSE)
 Revision 36124c7690b7
 [Read what was—and wasn’t—checked ↓](#review)

“A comprehensive Model Context Protocol (MCP) server for Grafana UI components.”

 [Miguel Palau · upstream description ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/package.json) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - index.ts connects StdioServerTransport to the SDK Server after setupHandlers. The opened file has no HTTP listen.
- The tool actions are get_component, get_demo, list_components, get_metadata, get_directory, get_documentation, get_stories, get_tests, search, get_theme_tokens, and get_dependencies. axios.ts uses GitHub GET or readFileSync.
- The pinned entrypoint is a stdio server that shows Grafana UI component source, docs, and stories to an assistant.
- A local Grafana checkout is preferred over the GitHub API, which is rate limited when no token is set.

### A good fit for

 - Inspect component props, stories and tests from a pinned Grafana checkout before editing UI code.
- Compare available design tokens and component exports against the application package version.
- Reading Grafana UI component source from a local clone
- The same lookup through the public GitHub API when a local checkout is not available

### Weigh up before choosing

 - The licence line is Copyright (c) 2025 Shadcn UI MCP Server. package.json names @shelldandy/grafana-ui-mcp-server and author Miguel Palau. This is not a Grafana Labs copyright line. The help text also names npx @jpisnice/grafana-ui-mcp-server. Neither package was installed.
- No ReadOnlyHint is set on the connected server. Default fetches use grafana/grafana branch main, which moves. get_directory accepts owner, repo, path, and branch on a GitHub GET. A resource template returns an npm install string and does not run it. The server was not started.
- Local mode is not a strict offline guarantee: missing files or an invalid repository can fall back to GitHub. Inspect whether a result reports local or github.
- README/package metadata use @shelldandy while embedded help also names @jpisnice. The example uses the reviewed source build, without asserting either published package matches it.
- Without a local path or a token, GitHub access is warned as 60 requests per hour.
- The help text asks for the public_repo scope, not a write scope.
- This entrypoint only connects a stdio transport; it does not listen on a port.
- A pin does not verify transitive dependencies.
- This review did not execute the resource.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - src/index.ts
- src/handler.ts
- src/tools.ts
- src/utils/axios.ts
- src/resources.ts
- src/prompts.ts
- src/resource-templates.ts
- package.json
- LICENSE
- 2026-10-14 reread of retained pinned setup/configuration evidence for the specific operational details added in this batch.
- README.md
- package.json

### Our findings

 - LICENSE is the MIT License. The copyright line is Copyright (c) 2025 Shadcn UI MCP Server.
- The opened axios, handler, resources, prompts, and template files contain no writeFile, post, put, or patch call. Header deletion in axios.ts is a Map delete of an Authorization header.
- Additional README/package inspection confirms local-path precedence, network fallback and the TypeScript build output. Existing attribution/package identity caveats remain.
- The process is a Model Context Protocol server for Grafana UI component source, documentation, stories, and metadata.
- A --grafana-repo-path or GRAFANA_REPO_PATH takes precedence over the GitHub API. If that local path fails, it falls back to a GitHub token.
- With neither a local repository nor a token, the file warns that GitHub is rate limited to 60 requests per hour. The server starts only on stdio.

### Not established by this review

 - The server was not started.
- No GitHub request was sent.
- No npx package was installed.
- No authenticated session, installation, permission bypass or package-to-source parity test was performed.
- The server was not started and its tools were not called.
- A pin does not verify transitive dependencies.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/README.md)

DOCUMENTED COMMAND

 npx @shelldandy/grafana-ui-mcp-server Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - The README’s quick start runs the npx line above. The npm scope is @shelldandy, and package.json at this commit uses the same name. It was not run.
- Pass a GitHub token with --github-api-key, GITHUB_PERSONAL_ACCESS_TOKEN or GITHUB_TOKEN, or point --grafana-repo-path or GRAFANA_REPO_PATH at a local grafana checkout. The README says the local path takes precedence.

### Before you start

 - Node.js with npx
- Optionally a GitHub token, or a local clone of grafana/grafana

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "grafana-ui": {
 "command": "npx",
 "args": [
 "@shelldandy/grafana-ui-mcp-server"
 ],
 "env": {
 "GRAFANA_REPO_PATH": "/path/to/your/grafana/repository"
 }
 }
 }
} Copy configuration ↗

### Compatibility

MCP stdio clients · Claude Desktop

### Implementation

TypeScript

### Transports

stdio

### Stdio server. Opened paths read GitHub or a local tree.

 - GitHub GET, or readFileSync after --grafana-repo-path
- Optional GitHub token from --github-api-key, GITHUB_PERSONAL_ACCESS_TOKEN, or GITHUB_TOKEN

### Cost model

MIT source at no charge. Copyright (c) 2025 Shadcn UI MCP Server. GitHub requests use the caller's network and any token the process was given.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Stdio entry ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/src/index.ts) Checked 2026-10-07 https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/src/index.ts Supports: transport, whySelected
- [GitHub and local reads ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/src/utils/axios.ts) Checked 2026-10-07 https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/src/utils/axios.ts Supports: GET and readFileSync, no write call in this file
- [MIT licence ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/LICENSE) Checked 2026-10-07 https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/LICENSE Supports: Redistribution terms, Copyright (c) 2025 Shadcn UI MCP Server
- [Additional pinned implementation/setup ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/README.md) Checked 2026-10-14 https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/README.md Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
- [Additional pinned implementation/setup ↗](https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/package.json) Checked 2026-10-14 https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/package.json Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Grafana docs MCP ↗ Four stdio tools search an in-memory Grafana docs index and GET pages under https://grafana.com/docs.](/mcp-servers/grafana-docs/)[### Svelte MCP ↗ Official Svelte documentation and static-analysis tools, available as a local process or a hosted MCP endpoint.](/mcp-servers/svelte/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
