← Explore all 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.

“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.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx @shelldandy/grafana-ui-mcp-server

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

  1. 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.
  2. 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.

  1. Stdio entry ↗Checked

    https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/src/index.ts

    Supports: transport, whySelected

  2. 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

  3. MIT licence ↗Checked

    https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/LICENSE

    Supports: Redistribution terms, Copyright (c) 2025 Shadcn UI MCP Server

  4. https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

  5. https://github.com/grafana/grafana-ui-mcp-server/blob/36124c7690b7e9e6979afa1976f75807cf7faeff/package.json

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

Evidence & Ask