使用说明

MCP堆栈-Grafana集成

人工智能驱动的监控集成通过模型上下文协议（MCP）将Grafana功能引入VS代码。

📚 文档文件

此目录包含MCP Grafana服务器的全面文档：

文件	目的
MCP_SERVER_GUIDE.md	完整的使用指南（从这里开始）
快速启动.md	快速参考命令
SETUP_AND_TROUBESHOTING.md	详细的设置和故障排除
docker-compose.yml	容器配置
.vcode/mcp.json	VS代码MCP客户端设置
.github/copilot-instructions.md	AI代理说明

🚀 快速启动（30秒）

启动MCP服务器

cd /home/ubuntu/mcp-stack
docker-compose up -d

验证它是否正在运行

docker ps | grep mcp-grafana

期望输出

mcp-grafana   Up 2 seconds   0.0.0.0:8000->8000/tcp

停止服务器

docker-compose down

🔍 什么是MCP？

模型上下文协议（MCP）是人工智能助手与外部服务交互的标准化方式。此设置使VS Code的AI助手能够访问Grafana监控和警报功能。

建筑

┌─────────────┐
│  VS Code    │ (MCP Client)
│  + AI Chat  │
└──────┬──────┘
       │ SSE Transport
       │ (Server-Sent Events)
       ▼
┌──────────────────────────┐
│  mcp-grafana Container   │ (MCP Server)
│  Port: 8000              │
└──────┬───────────────────┘
       │ HTTP API Requests
       ▼
┌──────────────────────────┐
│  Grafana Server          │
│  http://localhost:3000   │
└──────┬───────────────────┘
       │ Queries
       ▼
┌──────────────────────────┐
│  Prometheus              │
│  Metrics Storage         │
└──────────────────────────┘

⚡ 关键命令

# Start server
docker-compose up -d

# Stop server
docker-compose down

# Check status
docker ps | grep mcp-grafana

# View real-time logs
docker logs -f mcp-grafana

# Restart server
docker-compose restart mcp-grafana

# Full rebuild
docker-compose down && docker-compose pull && docker-compose up -d

🔧 配置

环境变量（docker compose.yml）

变量	值	注释
`GRAFANA_URL`	`http://localhost:3000`	内部Docker URL
`GRAFANA_SERVICE_ACCOUNT_TOKEN`	`glsa_xxxx...`	在Grafana管理中生成

VS代码设置（.vcode/mcp.json）

{
    "servers": {
        "grafana-monitoring": {
            "url": "http://localhost:8000",
            "transport": "sse"
        }
    }
}

📖 文档指南

入门指南

→ Read 快速启动.md （2分钟）

获取完整指南

→ Read MCP_SERVER_GUIDE.md （15分钟）

用于故障排除

→ Read SETUP_AND_TROUBESHOTING.md （10分钟）

对于AI代理

→ Read .github/copilot-instructions.md

✅ 验证检查表

[]已安装Docker和Docker Compose
[]Grafana跑步： docker ps | grep grafana
[]MCP服务器正在运行： docker-compose up -d
[]端口8000打开： curl http://localhost:8000/
[]从集装箱可以到达Grafana： docker exec mcp-grafana curl http://grafana:3000/api/org
[]VS Code已安装MCP扩展
[ ] .vscode/mcp.json 配置正确
[]VS Code显示“grafana监控”已连接

🐛 故障排除

快速诊断

# 1. Is container running?
docker ps | grep mcp-grafana

# 2. Are logs clean?
docker logs mcp-grafana

# 3. Can we reach it?
curl http://localhost:8000/

# 4. Can it reach Grafana?
docker exec mcp-grafana curl http://grafana:3000/api/org

常见问题

问题	解决方案
端口8000正在使用中	更改端口 `docker-compose.yml`
容器无法启动	检查 `GRAFANA_SERVICE_ACCOUNT_TOKEN` 有效
VS代码显示已断开连接	重新启动： `docker-compose restart mcp-grafana`
无法访问Grafana	验证Grafana正在运行 `/home/ubuntu/monitoring/`

详细故障排除，请参阅 SETUP_AND_TROUBESHOTING.md

📁 项目结构

/home/ubuntu/mcp-stack/
├── docker-compose.yml                    # Container definition & config
├── .vscode/
│   ├── settings.json                    # VS Code settings
│   └── mcp.json                         # MCP server configuration
├── .github/
│   └── copilot-instructions.md          # AI agent guidance
├── README.md                            # This file
├── QUICK_START.md                       # Quick reference
├── MCP_SERVER_GUIDE.md                  # Complete guide
├── SETUP_AND_TROUBLESHOOTING.md         # Setup & troubleshooting
└── health-check.sh                      # Diagnostic script

🔗 相关项目

MCP服务器集成了：

监控堆栈: /home/ubuntu/monitoring/
- 格拉法娜：http://localhost:3000
- 普罗米修斯：http://localhost:9090
- 节点导出器：端口9100
- 文档： ALERT_SETUP.md, GOOGLE_CHAT_QUICK_START.txt

📚 参考文献

🚦 状态指示

服务	状态命令	需要
MCP服务器	`docker ps \| grep mcp-grafana`	在端口8000上运行
伯爵	`docker ps \| grep grafana`	在端口3000上运行
普罗米修斯	`docker ps \| grep prometheus`	在端口9090上运行

💡 提示

保持日志打开 在开发过程中： docker logs -f mcp-grafana
测试连接性 经常： curl http://localhost:8000/
监控资源使用情况: docker stats mcp-grafana
定期更新令牌 出于安全考虑

🆘 获取帮助

检查日志： docker logs mcp-grafana
查阅相关指导文件（见上文）
运行诊断：请参阅SETUP_AND_TRUBLESHOOTING.md
验证是否满足所有先决条件

📝 许可证和信用证

MCP协议：开放标准
Grafana MCP服务器：Grafana官方项目
设置：配置用于监控基础设施 /home/ubuntu/