使用说明

项目简介

Prometheus MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它允许 LLM (如 Claude) 应用访问 Prometheus 监控系统中的指标数据。通过这个服务器，LLM 可以获取 Prometheus 中存储的各种性能指标，从而更好地理解和响应环境变化。

主要功能点

指标数据访问: 可以列出和访问 Prometheus 服务器上的指标数据。
指标详情: 针对每个指标，可以获取指标名称、描述、元数据以及统计信息（如计数、最小值、最大值）。
JSON 数据格式: 以结构化的 JSON 格式提供指标数据，方便 LLM 应用解析和使用。
基础认证: 支持 Prometheus 服务器的基础认证，确保数据访问安全。

安装步骤

安装依赖: 首先确保你的机器上安装了 Node.js 和 npm。然后，克隆该仓库到本地，并在仓库根目录下运行以下命令安装项目依赖：
```
npm install
```
构建项目: 安装依赖完成后，运行以下命令构建项目，生成可执行的服务器程序：
```
npm run build
```

服务器配置

要将此 MCP 服务器添加到 MCP 客户端（例如 Claude Desktop），你需要配置客户端的服务器配置文件。以 Claude Desktop 为例，你需要编辑配置文件（MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json', Windows: '%APPDATA%/Claude/claude_desktop_config.json'），添加如下服务器配置信息。

请注意，你需要将 '/path/to/mcp-server-prometheus/build/index.js' 替换为 你实际的 'mcp-server-prometheus' 项目 'build/index.js' 文件的绝对路径。同时，请将 'http://your-prometheus-instance:9090' 替换为 你的 Prometheus 服务器的实际地址。

{
  "mcpServers": {
    "mcp-server-prometheus": {
      "command": "/path/to/mcp-server-prometheus/build/index.js",
      "env": {
        "PROMETHEUS_URL": "http://your-prometheus-instance:9090"
        // 如果你的Prometheus服务器需要用户名和密码进行基础认证，请添加以下配置
        // "PROMETHEUS_USERNAME": "your_prometheus_username",
        // "PROMETHEUS_PASSWORD": "your_prometheus_password"
      }
    }
  }
}

配置参数说明:

'server name': 'mcp-server-prometheus' - 服务器名称，用于在 MCP 客户端中标识该服务器。
'command': '/path/to/mcp-server-prometheus/build/index.js' - MCP 服务器的启动命令，指向构建后的 'index.js' 文件。
'env': 环境变量配置，用于传递服务器运行所需的参数。
- 'PROMETHEUS_URL': 必填，你的 Prometheus 服务器的 URL 地址 (例如 'http://your-prometheus-instance:9090')。
- 'PROMETHEUS_USERNAME': 可选，Prometheus 服务器基础认证的用户名 (如果需要)。
- 'PROMETHEUS_PASSWORD': 可选，Prometheus 服务器基础认证的密码 (如果需要)。

基本使用方法

配置完成后，启动你的 MCP 客户端 (如 Claude Desktop)。客户端应该能够识别并连接到 Prometheus MCP Server。之后，你可以指示 LLM 应用使用 'mcp-server-prometheus' 服务器提供的资源，例如查询 Prometheus 指标数据，从而将 Prometheus 的监控信息引入到 LLM 的上下文理解和生成过程中。

例如，在 Claude 中，你可以指示 Claude 从 'mcp-server-prometheus' 服务器获取 Prometheus 指标数据，并基于这些数据进行分析或决策。具体的指令方式取决于 MCP 客户端的功能和用户界面。

关键词