pMCP (Yshngg)

Prometheus模型上下文协议服务器

  

Prometheus的基于Golang的模型上下文协议（MCP）服务器实现，支持与Prometheus度量和查询的自然语言交互。

用Go构建, prometheus-mcp-server 提供了一个强大的、类型安全的接口，该接口与Prometheus HTTP API保持完全一致，允许您通过与兼容MCP的客户端进行自然语言对话来查询和管理普罗米修斯实例。

______________________________________________________________________

目录

1. 特性
2. 建筑
3. 需求
4. 安装
5. 用法

- 命令行标志

1. API兼容性
2. 绑定块

- 工具 - 提示

1. 贡献
2. 许可证
3. 致谢

______________________________________________________________________

特性

• 🔥 Golang实施：采用Go 1.23+构建，性能、可靠性和类型安全
• 📊 完整的Prometheus API覆盖范围：与Prometheus HTTP API v1完全兼容
• ⚡ 即时查询：在特定时间点执行Prometheus查询
• 📈 范围查询：检索定义时间范围内的历史度量数据
• 🔍 元数据查询：发现时间序列、标签名称和标签值
• 🎯 目标和规则管理：监视目标、规则和警报配置
• 🛠️ TSDB管理：高级数据库操作，包括快照和系列删除
• 🌐 多种运输方式：支持HTTP、服务器发送事件（SSE）和stdio
• 🤖 MCP集成：与Claude Desktop等MCP兼容客户端无缝通信

______________________________________________________________________

建筑

prometheus-mcp-server 被设计为 Golang微服务 它充当MCP客户端和Prometheus服务器之间的桥梁。它提供：

• 类型安全的API绑定 使用镜像Prometheus API响应的Go结构
• 模块化封装结构 可维护性和可扩展性
• 全面的错误处理 通过适当的Go错误传播
• 清晰地分离关注点 在传输、API客户端和业务逻辑之间

______________________________________________________________________

需求

• 转到1.23.0 或更高
• 跑步 普罗米修斯服务器 （v2.x）
• 兼容的MCP客户端（Claude Desktop、自定义实现等）

______________________________________________________________________

安装

使用Docker（推荐）

从GitHub容器注册表中提取预构建映像：

# Pull the latest image
docker pull ghcr.io/yshngg/prometheus-mcp-server:latest

# Run with stdio transport (for desktop clients)
docker run --rm ghcr.io/yshngg/prometheus-mcp-server:latest --prom-addr="http://host.docker.internal:9090"

# Run with HTTP transport
docker run --rm -p 8080:8080 ghcr.io/yshngg/prometheus-mcp-server:latest --prom-addr="http://host.docker.internal:9090" --transport=http --mcp-addr="0.0.0.0:8080"

或者，在本地构建：

docker build -t prometheus-mcp-server .
docker run -p 8080:8080 prometheus-mcp-server --prom-addr="http://prometheus:9090" --transport=http

下载预构建二进制文件

从GitHub下载最新版本：

1. 首选 prometheus-mcp-server 发布
2. 从以下网址下载适用于您平台的二进制文件 资产 部分
3. 提取并运行：

# Linux/macOS example
tar -xzf prometheus-mcp-server-.linux-amd64.tar.gz
./prometheus-mcp-server --prom-addr="http://localhost:9090"

# Windows example
unzip prometheus-mcp-server-.windows-amd64.zip
prometheus-mcp-server.exe --prom-addr="http://localhost:9090"

从源头构建

git clone https://github.com/yshngg/prometheus-mcp-server.git
cd prometheus-mcp-server
make build
# Binary will be available as ./prometheus-mcp-server

使用Go安装

安装 prometheus-mcp-server 二进制直接从源：

go install github.com/yshngg/prometheus-mcp-server@latest

确保 $GOPATH/bin 在你的 $PATH.

______________________________________________________________________

用法

通过指定Prometheus地址和首选传输来运行服务器：

# Default (stdio transport) - ideal for desktop clients
prometheus-mcp-server --prom-addr="http://localhost:9090"

# HTTP transport - for web-based integrations
prometheus-mcp-server --prom-addr="http://localhost:9090" --transport=http --mcp-addr="localhost:8080"

# SSE transport - for real-time streaming (deprecated, use HTTP)
prometheus-mcp-server --prom-addr="http://localhost:9090" --transport=sse --mcp-addr="localhost:8080"

命令行标志

______________________________________________________________________

API兼容性

prometheus-mcp-server 维持 100%兼容性 使用Prometheus HTTP API v1。每个工具和端点都直接对应于官方的Prometheus API：

查询和数据检索

元数据和发现

规则和警报

状态和配置

TSDB管理

管理API

所有查询参数、响应格式和错误代码都符合官方的Prometheus API规范。

______________________________________________________________________

绑定块

工具

表达式查询 （普罗米修斯核心功能）：

• 即时查询：在单个时间点评估即时查询
• 范围查询：在一段时间内计算表达式查询

元数据查询 （系列和标签发现）：

• 按标签查找系列：返回与特定标签集匹配的时间序列列表
• 列出标签名称：返回标签名称列表
• 列出标签值：返回所提供标签名称的标签值列表
• 目标元数据查询：返回当前从目标中抓取的指标的元数据
• 度量元数据查询：返回当前从目标中抓取的指标的元数据（没有目标信息）

发现与监控:

• 发现目标：返回普罗米修斯目标发现的当前状态概述
• 警报查询：返回所有活动警报的列表
• 规则查询：返回当前加载的警报和记录规则列表
• 警报管理器发现：返回Prometheus警报管理器发现的当前状态概述

状态和配置:

• 配置：返回当前加载的配置文件
• 旗帜：返回Prometheus配置的标志值
• 运行时信息：返回有关Prometheus服务器的各种运行时信息属性
• 构建信息：返回有关Prometheus服务器的各种构建信息属性
• TSDB统计数据：返回有关Prometheus TSDB的各种基数统计信息
• WAL重播统计数据：返回有关WAL重播的信息

TSDB管理API （高级操作）：

• TSDB快照：将所有当前数据的快照创建为快照/`-`
• 删除系列：删除时间范围内选定系列的数据
• 清理墓碑：从磁盘中删除已删除的数据并清理现有的墓碑

管理API:

• 健康检查：检查普罗米修斯健康状况
• 准备检查：检查Prometheus是否已准备好为流量提供服务（即响应查询）
• 重新加载：触发重新加载Prometheus配置和规则文件
• 退出：触发普罗米修斯的优雅关机

提示

• 所有可用指标：返回Prometheus实例暴露的每个指标的列表

______________________________________________________________________

贡献

欢迎投稿！这是一个 Golang项目，因此请确保：

• 遵循Go最佳实践和惯例
• 为新功能添加适当的测试
• 保持API与普罗米修斯的兼容性
• 根据需要更新文档

请提交一个pull请求或打开一个问题来讨论改进。

开发环境

git clone https://github.com/yshngg/prometheus-mcp-server.git
cd prometheus-mcp-server
go mod download
make build

______________________________________________________________________

许可证

此项目根据Apache许可证2.0获得许可。请参阅 许可证 文件以获取详细信息。

______________________________________________________________________


致谢

• 用Go构建 使用官方 Prometheus Go客户端库
• 由...驱动 模型上下文协议Go SDK
• 受启发于 普罗米修斯 -监测和警报的事实标准