https://github.com/etruong42/prometheus-mcp

MCP server to connect LLMs with Prometheus HTTP API
https://github.com/etruong42/prometheus-mcp

Last synced: about 2 months ago
JSON representation

MCP server to connect LLMs with Prometheus HTTP API

• Host: GitHub
• URL: https://github.com/etruong42/prometheus-mcp
• Owner: etruong42
• License: mit
• Created: 2025-04-16T01:18:34.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-04-24T12:18:11.000Z (2 months ago)
• Last Synced: 2025-04-24T13:28:20.395Z (2 months ago)
• Language: Python
• Size: 11.2 MB
• Stars: 0
• Watchers: 1
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-devops-mcp-servers - etruong42/prometheus-mcp - MCP server to connect LLMs with Prometheus HTTP API for metrics querying and analysis. (Monitoring & Observability / 📊 Metrics & Monitoring)
• awesome-devops-mcp-servers - etruong42/prometheus-mcp - MCP server to connect LLMs with Prometheus HTTP API for metrics querying and analysis. (Monitoring & Observability / 📊 Metrics & Monitoring)
• mcp-index - Prometheus MCP Server - Exposes Prometheus monitoring and visualization tools to language model agents for querying metrics and generating charts dynamically. Provides real-time observability data and graphical insights, facilitating integration with MCP-compatible clients like Claude. (APIs and HTTP Requests)

README

        
# Prometheus MCP

Proof-of-concept Prometheus MCP server.

## Prerequisites

Install `uv`: 

Using `uv`, you can also install python.

## How to run

Clone this repo.

Update the .env file

```

uv add "mcp[cli]" pillow google-auth matplotlib requests python-dotenv

```

## Integrating with Claude

You can run the server with

```

uv --directory "/directory/to/prometheus-mcp" run server.py

```

So you may add this MCP server to your Claude MCP server configuration

```

{

  "mcpServers": {

      "Prometheus MCP": {

          "command": "/path/to/uv",

          "args": [

              "--directory",

              "/directory/to/prometheus-mcp",

              "run",

              "server.py"

          ]

      }

  }

}

```

See [MCP Quickstart](https://modelcontextprotocol.io/quickstart/server#testing-your-server-with-claude-for-desktop)

for more details for Claude specific instructions.

## Demo

[![Demo gif](./docs/prom-mcp-demo.gif '')](https://github.com/etruong42/prometheus-mcp/raw/refs/heads/main/docs/prometheus-demo-video.mp4)

[Link to shared Claude chat in demo](https://claude.ai/share/c89412c1-5f19-430a-8c85-bf3c05033f81)