MCP服务器POC图
此存储库包含一个概念验证实现,用于学习和理解Grafana MCP(模型上下文协议)服务器的工作原理。
概述
模型上下文协议(MCP)是一种协议,使AI助手能够安全地访问外部系统并与之交互。本POC演示了如何创建一个与Grafana集成的MCP服务器,用于监控和可观察性用例。
特性
- MCP服务器实现:一个可以与Grafana交互的完整MCP服务器
- Grafana集成:示例配置和仪表板
- Docker设置:完整的集装箱化环境
- 样品数据:用于测试的模拟指标和监控数据
- 文档:综合指南和示例
快速开始
先决条件
- Docker和Docker Compose
- Node.js 18+(用于本地开发)
- Git
使用Docker(推荐)
- 克隆存储库:
git clone https://github.com/shesadri/mcp_grafana_poc.git
cd mcp_grafana_poc- 启动整个堆栈:
docker-compose up -d- 访问服务:
- 图表 :http://localhost:3000 (管理员/管理员)
- MCP服务器:http://localhost:8080
- 普罗米修斯:http://localhost:9090
地方发展
- 安装依赖项:
npm install- 启动MCP服务器:
npm start- 在开发模式下运行:
npm run dev建筑
┌─────────────┐ ┌──────────────┐ ┌─────────────┐
│ Client │────│ MCP Server │────│ Grafana │
│ (AI Agent) │ │ │ │ │
└─────────────┘ └──────────────┘ └─────────────┘
│
┌──────────────┐
│ Prometheus │
│ (Data Source)│
└──────────────┘MCP服务器功能
MCP服务器提供以下工具:
query_metrics:从Grafana/Prometheus查询指标create_dashboard:创建新的Grafana仪表板get_alerts:检索警报信息search_logs:搜索日志数据health_check:检查系统运行状况
文件结构
.
├── src/
│ ├── server.js # Main MCP server implementation
│ ├── tools/ # MCP tool implementations
│ └── utils/ # Utility functions
├── config/
│ ├── grafana/ # Grafana configuration files
│ └── prometheus/ # Prometheus configuration
├── docker/
│ ├── Dockerfile # MCP server container
│ └── docker-compose.yml # Complete stack setup
├── examples/ # Sample queries and usage
├── docs/ # Documentation
└── package.json # Node.js dependencies贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用,添加测试
- 提交拉取请求
学习资源
许可证
MIT许可证-有关详细信息,请参阅许可证文件
支持
有关问题和支持,请在此存储库中打开问题。
