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.
“A comprehensive Model Context Protocol (MCP) server for Grafana UI components.”
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.
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.
DOCUMENTED COMMAND
npx @shelldandy/grafana-ui-mcp-server 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"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Stdio entry ↗Checked
https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/src/index.ts
Supports: transport, whySelected
- GitHub and local reads ↗Checked
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 ↗Checked
https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/LICENSE
Supports: Redistribution terms, Copyright (c) 2025 Shadcn UI MCP Server
https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/README.md
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/package.json
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports