GitHub
server ทางการของ GitHub ให้ AI อ่านและจัดการโค้ด issue และ pull request ในบัญชีของคุณได้ ใช้ผ่านคลาวด์ของ GitHub หรือรันในเครื่องด้วย Docker ก็ได้
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Read-only project-level Grafana MCP: Loki logs, metrics, traces, alerts, test/prod switching
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
GRAFANA_TEST_URL, GRAFANA_TEST_USER, GRAFANA_TEST_PASSWORD, GRAFANA_PROD_URL, GRAFANA_PROD_USER, GRAFANA_PROD_PASSWORD, GRAFANA_ENV, GRAFANA_APPค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"grafana": {
"command": "npx",
"args": [
"-y",
"grafana-mcp"
],
"env": {
"GRAFANA_TEST_URL": "ใส่ค่าของคุณ",
"GRAFANA_TEST_USER": "ใส่ค่าของคุณ",
"GRAFANA_TEST_PASSWORD": "ใส่ค่าของคุณ",
"GRAFANA_PROD_URL": "ใส่ค่าของคุณ",
"GRAFANA_PROD_USER": "ใส่ค่าของคุณ",
"GRAFANA_PROD_PASSWORD": "ใส่ค่าของคุณ",
"GRAFANA_ENV": "ใส่ค่าของคุณ",
"GRAFANA_APP": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add grafana --env GRAFANA_TEST_URL='ใส่ค่าของคุณ' --env GRAFANA_TEST_USER='ใส่ค่าของคุณ' --env GRAFANA_TEST_PASSWORD='ใส่ค่าของคุณ' --env GRAFANA_PROD_URL='ใส่ค่าของคุณ' --env GRAFANA_PROD_USER='ใส่ค่าของคุณ' --env GRAFANA_PROD_PASSWORD='ใส่ค่าของคุณ' --env GRAFANA_ENV='ใส่ค่าของคุณ' --env GRAFANA_APP='ใส่ค่าของคุณ' -- npx -y grafana-mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"grafana": {
"command": "npx",
"args": [
"-y",
"grafana-mcp"
],
"env": {
"GRAFANA_TEST_URL": "ใส่ค่าของคุณ",
"GRAFANA_TEST_USER": "ใส่ค่าของคุณ",
"GRAFANA_TEST_PASSWORD": "ใส่ค่าของคุณ",
"GRAFANA_PROD_URL": "ใส่ค่าของคุณ",
"GRAFANA_PROD_USER": "ใส่ค่าของคุณ",
"GRAFANA_PROD_PASSWORD": "ใส่ค่าของคุณ",
"GRAFANA_ENV": "ใส่ค่าของคุณ",
"GRAFANA_APP": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"grafana": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"grafana-mcp"
],
"env": {
"GRAFANA_TEST_URL": "ใส่ค่าของคุณ",
"GRAFANA_TEST_USER": "ใส่ค่าของคุณ",
"GRAFANA_TEST_PASSWORD": "ใส่ค่าของคุณ",
"GRAFANA_PROD_URL": "ใส่ค่าของคุณ",
"GRAFANA_PROD_USER": "ใส่ค่าของคุณ",
"GRAFANA_PROD_PASSWORD": "ใส่ค่าของคุณ",
"GRAFANA_ENV": "ใส่ค่าของคุณ",
"GRAFANA_APP": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
GRAFANA_TEST_URL envGRAFANA_TEST_USER envGRAFANA_PROD_URL envGRAFANA_PROD_USER envGRAFANA_ENV envGRAFANA_APP envค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub itzhouq ซึ่งเป็นเจ้าของ repo
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: GRAFANA_TEST_PASSWORD, GRAFANA_PROD_PASSWORD
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.3) เข้า registry 31 วันที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
ในหมวดเดียวกันมี GitHub, Desktop Commander, Cloudflare MCP
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
server ทางการของ GitHub ให้ AI อ่านและจัดการโค้ด issue และ pull request ในบัญชีของคุณได้ ใช้ผ่านคลาวด์ของ GitHub หรือรันในเครื่องด้วย Docker ก็ได้
MCP server for terminal commands, file operations, and process management
Cloudflare MCP servers
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
Project-level Grafana MCP server — give your AI coding agent read-only access to Loki logs, Prometheus metrics, Tempo traces and alerts, with per-project context and test/prod environment switching. 零依赖单文件 TypeScript,bun 直接运行。
AI 编码 Agent(Claude Code / Cursor / …)
│ MCP (stdio) ▼ grafana-mcp ──读──▶ .mcp.json env / .grafana.json / ~/.zshrc(凭据与项目上下文) │ HTTP(只读查询 API) ▼ Grafana ──▶ Loki(日志)/ Prometheus(指标)/ Tempo(链路)/ Alerts(告警)
日常迭代业务系统时,测试阶段要快速定位 QA 反馈的问题,线上要快速排查功能 bug 与性能瓶颈——这些证据都在 Grafana 体系里(Loki 日志、Prometheus 指标、Tempo 链路)。让 agent 在写代码、修 bug 的同时能直接查到这些上下文,问题定位的效率和准确性会明显提升。但直接用通用 MCP 封装 Grafana API 会遇到三个实际障碍:
| 痛点 | 本实现的解法 |
|---|---|
| 每个项目会话都要口头告诉 agent "我们的应用在 Grafana 里叫什么",容易跑偏 | 项目根放一个 .grafana.json 或在 .mcp.json env 中配置(app、namespace、默认环境),agent 调 project_context 一次对齐方向 |
| test / prod 双环境凭据区分,而 MCP server 由客户端 spawn,是非交互 shell,不会 source `.zshrc`,环境变量读不到 | 三选一:① .mcp.json env 直接传 GRAFANA_{ENV}_*(零全局依赖)② server 启动时解析 ~/.zshrc / ~/.zshenv 文件文本 ③ 全局配置文件 |
| 多数据源实例上"按类型取第一个"容易选错 | 优先使用显式配置的数据源 UID,支持按环境指定 |
前提:本机已安装 bun(curl -fsSL https://bun.sh/install | bash)。项目零 npm 依赖,无需 npm install。
所有信息(test/prod 双环境地址、凭据、数据源 UID、项目 app 名称)全部写在项目 .mcp.json 中,不依赖 ~/.zshrc,换台机器只需复制 .mcp.json:
{
"mcpServers": { "grafana": { "command": "bunx", "args": ["grafana-mcp"], "env": { "GRAFANA_ENV": "test", "GRAFANA_APP": "my-app", "GRAFANA_NAMESPACE": "my-namespace",
"GRAFANA_TEST_URL": "https://grafana.test.example.com", "GRAFANA_TEST_USER": "viewer", "GRAFANA_TEST_PASSWORD": "********", "GRAFANA_TEST_LOKI_DATASOURCE": "loki-uid-here", "GRAFANA_TEST_PROMETHEUS_DATASOURCE": "prom-uid-here",
"GRAFANA_PROD_URL": "https://grafana.prod.example.com", "GRAFANA_PROD_USER": "viewer", "GRAFANA_PROD_PASSWORD": "********", "GRAFANA_PROD_LOKI_DATASOURCE": "loki-uid-prod", "GRAFANA_PROD_PROMETHEUS_DATASOURCE": "prom-uid-prod" } } } }
配置好后:
project_context 会自动显示当前环境、可用环境列表、项目 app 等信息switch_environment 可在 test/prod 之间切换(仅影响当前会话)loki_query 会自动注入 app="my-app" 标签(传 injectApp=false 关闭)⚠️
.mcp.json含明文凭据,务必加入.gitignore。
适合多项目共享同一套 Grafana 凭据的场景。凭据配在 ~/.zshrc 中(一次性),每个项目只配项目上下文:
项目 `.mcp.json`(只配项目上下文,不含凭据):
{
"mcpServers": { "grafana": { "command": "bunx", "args": ["grafana-mcp"], "env": { "GRAFANA_ENV": "test", "GRAFANA_APP": "my-app" } } } }
或项目 `.grafana.json`(承载更多信息,对 agent 可见可解释):
{
"defaultEnv": "test", "app": "my-app", "appLabel": "app", "namespace": "my-namespace", "notes": "本项目日志标签 app=my-app;查指标时 pod 前缀为 my-app-" }
| 字段 | 说明 |
|---|---|
defaultEnv | 默认环境(test / prod / 自定义) |
app | 应用在 Loki 中的 app 标签值,loki_query 会自动注入到查询 selector |
appLabel | app 标签名,默认 app |
namespace | 默认 namespace,供 agent 参考 |
notes | 自由文本备注,project_context 会原样带给 agent |
environments.{env}.url | 该环境的 Grafana 地址(覆盖 zshrc 中的同名变量) |
environments.{env}.user | 该环境的用户名 |
environments.{env}.password | 该环境的密码 |
environments.{env}.app | 该环境的 app 标签值(同一项目 test/prod 命名不同时用,优先于顶层 app) |
environments.{env}.appLabel | 该环境的 app 标签名,默认 app |
environments.{env}.datasources | 按环境指定数据源 UID(loki/prometheus/tempo) |
⚠️
.grafana.json的notes和environments可能包含敏感信息——建议加入.gitignore。
进程环境变量(.mcp.json env:GRAFANA_{ENV}_URL 等按环境,或 GRAFANA_URL 直连)
→ 项目 .grafana.json 的 environments.{env} 字段 → 全局配置 ~/.config/grafana-mcp/config.json(可选,适合无 .zshrc 的机器) → ~/.zshrc + ~/.zshenv 文本解析(适合全机统一配置)
不依赖 shell 环境:MCP server 由客户端 spawn,是非交互、非登录 shell,不会 source rc 文件。本实现直接解析 rc 文件文本或从进程环境变量读取,这是特性而非 workaround。
偏好克隆使用的话:
git clone https://github.com/itzhouq/grafana-mcp.git && cd grafana-mcp
bun run index.ts # stdio JSON-RPC,接入任意 MCP 客户端
.mcp.json 中对应写 "command": "bun", "args": ["run", "/path/to/grafana-mcp/index.ts"]。
| 工具 | 说明 |
|---|---|
project_context | 调查前必调:激活环境、可用环境、项目 App/namespace、数据源 UID、配置来源(密码脱敏输出) |
switch_environment | 切换 test/prod(仅影响当前会话),返回新环境上下文 |
loki_query | LogQL 日志查询;项目配置了 app 时自动注入 selector(injectApp=false 可关) |
loki_labels | 列 Loki 标签名,或查某标签全部取值(如确认 app 名称在当前环境是否存在) |
prom_query | PromQL 区间查询 |
prom_instant | PromQL 即时查询 |
tempo_search | TraceQL 链路搜索 |
tempo_trace | 按 traceID 查看完整链路 |
alerts | 当前正在告警的规则 |
datasources | 列出全部数据源 |
时间参数(loki/prom/tempo 通用):range(默认 1h,如 30m/6h/24h)、start/end(ISO 8601 绝对时间)、limit。
Grafana 官方也提供 MCP server(Go 实现,面向全局单实例的完整工具集)。两者定位不同,可并存:
| grafana-mcp(本仓库) | 官方 mcp-grafana | |
|---|---|---|
| 使用粒度 | 项目级:项目根 .grafana.json 声明上下文,project_context 一次对齐 | 全局实例,项目信息需每次口头提供 |
| 多环境 | test/prod 双环境一等公民,switch_environment 一键切换 | 面向单一实例配置 |
| 凭据来源 | .mcp.json env(零全局依赖)/ ~/.zshrc 文本解析 / 全局配置文件(三选一,可混用) | 环境变量 |
| 形态 | 零依赖单文件 TypeScript,bun 直接运行 | Go 二进制 / Docker |
选型建议:要全量 Grafana 管理能力用官方;要"每个业务项目开箱即用的日志/指标排查上下文 + 双环境",用本仓库。
~/.zshrc(或进程环境),MCP server 仅在本机内存中使用,不落盘、不回显(project_context 输出对密码脱敏)。~/.config/grafana-mcp/config.json 并 chmod 600,~/.zshrc 中的同名变量会被其覆盖。GRAFANA_OP_VAULT / GRAFANA_OP_ITEM 后,无账密时通过 op CLI 取凭据。为什么 agent 读不到 `.zshrc` 里的环境变量? MCP server 由客户端 spawn,是非交互、非登录 shell,不会 source rc 文件。本实现提供三种解法:① 在 .mcp.json env 中直接配 GRAFANA_{ENV}_*(推荐)② server 解析 rc 文件文本 ③ 用全局配置文件。
不想装 bun? 当前运行时依赖 bun(单文件 TS 直跑是刻意的设计取舍)。Node 兼容的编译产物在 Roadmap 中,欢迎 issue 催更。
查询结果太长被截断? 超过 6 万字符自动截断并提示缩小范围;命中 limit 上限时也会明确提示可能还有更多。建议总是带 range 与 limit。
数据源选错了? 在 GRAFANA_{ENV}_LOKI_DATASOURCE 等变量或 .grafana.json 的 environments.{env}.datasources 中显式指定 UID。
bun run smoke # MCP 协议握手 + 工具清单 + project_context;本机配好凭据后自动追加真实查询
bun run test # 冒烟 + 集成测试(项目上下文发现、app 注入、prod 切换;需要真实凭据,CI 跳过)
CI 只运行无凭据的协议级冒烟测试与敏感信息扫描;集成测试需要真实 Grafana 环境,请在本机运行。
itzhouq — 个人网站 itzhouq.cn,在那里持续 build in public。其他开源工具:
欢迎 issue / PR;安全漏洞请走 SECURITY.md 的私密渠道,不要开 public issue。
mcp-name: io.github.itzhouq/grafana-mcp