mcpField
A
assistant-mcp

assistant-mcp

github.com/grafanaAgent 工作流2955.1k 次安装1 天前更新
代码仓库

关于 assistant-mcp

用于通过 Grafana MCP 服务将 AI Agent 连接到 Grafana Cloud 的配置技能，介绍 stdio 和 SSE 设置、常见工作流及访问令牌安全措施。

主要功能

  1. 01stdio 与 SSE 配置指引
  2. 02Claude Code 和 Cursor 配置
  3. 03Grafana 工具发现
  4. 04令牌与权限安全建议
  5. 05故障排查指引

适用场景

  1. 01将 Agent 连接到 Grafana Cloud
  2. 02通过 SSE 与团队共享服务
  3. 03限制 Agent 仅具只读权限
  4. 04排查 MCP 工具调用失败

MCP 相关

此技能用于配置 Grafana MCP 服务，该服务向 Agent 暴露 Grafana Cloud 能力作为工具。内容涵盖 stdio 和 SSE 传输方式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/grafana/skills --skill assistant-mcp

安装后在 Claude Code 中输入/assistant-mcp确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
a2a.md
sse-transport.md
tools.md

详细介绍

Grafana Cloud MCP 服务设置

Grafana MCP 服务通过 Model Context Protocol 将 Grafana Cloud 的功能作为工具提供，供 AI Agent 调用。Agent 随后可以查询指标、搜索仪表板、管理警报、调查事件，以及与 Fleet Management 交互，而无需离开编码环境。

传输方式：stdio（Agent 将服务作为子进程启动，最简单），或 SSE（服务独立运行，Agent 通过 HTTP 连接——参见 references/sse-transport.md）。

常见工作流

将 Claude Code 连接到 Grafana（stdio）
# 1. Install the server
go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest

# 2. Verify the binary
mcp-grafana --version
# If "command not found": ensure $GOPATH/bin (or $HOME/go/bin) is on PATH.

  1. 获取服务账号令牌：Grafana Cloud → Administration → Service Accounts → 创建具有 Viewer 角色的账号（仅在需要写入时添加 Editor）→ 生成令牌。记下 Grafana URL（例如 https://myorg.grafana.net）。

  2. 配置 ~/.claude/settings.json（或项目本地的 .claude/settings.json）：

    {
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["--disable-write"],
      "env": {
        "GRAFANA_URL": "https://myorg.grafana.net",
        "GRAFANA_API_KEY": "glsa_xxxx"
      }
    }
  }
}

    --disable-write 是更安全的默认设置——确认读取正常后再将其移除。

  3. 重启 Claude Code，然后验证：

    /mcp

    grafana 服务应显示其工具列表。然后询问：

    What data sources are configured in my Grafana instance?

    若响应正常，则表示运行正常。如果工具调用失败：

    • 检查 GRAFANA_URL 末尾没有斜杠
    • 确认 API 密钥尚未过期
    • 使用 mcp-grafana --debug 重新运行，以查看原始请求/响应
连接 Cursor

使用相同的 Grafana 令牌。进入 Settings → Features → MCP Servers（或编辑 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["--disable-write"],
      "env": {
        "GRAFANA_URL": "https://myorg.grafana.net",
        "GRAFANA_API_KEY": "glsa_xxxx"
      }
    }
  }
}

使用相同方式验证——Cursor 会在其 Agent 面板中显示 MCP 服务；运行类似“列出标记为 kubernetes 的仪表板”这样的查询。

在团队中共享服务（SSE）

从 stdio 切换到 SSE，让服务只运行一次，供多个 Agent 连接。包含 VS Code 配置的完整设置说明见 references/sse-transport.md。

安全注意事项

  • API 密钥应放在环境变量或密钥管理器中——切勿提交到文件中。
  • 在共享环境和 CI 中使用 --disable-write；只有在允许 Agent 修改 Grafana 的特定机器上才移除它。
  • 将服务账号权限限制在最低限度：Viewer 足以用于查询和读取仪表板。只有当 Agent 需要创建仪表板或注释时，才授予 Editor。
  • 定期通过 Administration → Service Accounts 轮换令牌。

参考资料

  • references/tools.md — MCP 工具完整列表（查询 / 仪表板 / 警报 / Fleet Management / 注释），以及如何发现当前可用工具
  • references/sse-transport.md — 用于团队共享和 VS Code 的 SSE 设置，包含 stdio 与 SSE 的选择矩阵及常见故障模式
  • references/a2a.md — 用于委托推理给 Grafana Assistant 的 Agent-to-Agent（A2A）协议（与通过 MCP 直接调用工具相对）

外部资源

评论

支持 Markdown