Loglmhq MCP Server Prometheus

🚀 mcp-server-prometheus

An MCP server for interacting with Prometheus metrics and data.

This is a TypeScript-based MCP server that implements a Prometheus API interface. It provides a bridge for Claude via the Model Context Protocol (MCP), enabling it to interact with your Prometheus server.

🎥 Demo

✨ Features

Resources

• List and access the Prometheus metric schema.
• Each metric resource provides the following information:
  • Metric name and description.
  • Detailed metadata from Prometheus.
  • Statistical information (count, minimum, maximum).
• JSON MIME type for structured data access.

Current Capabilities

• List all available Prometheus metrics and their descriptions.
• Read detailed metric information, including:
  • Metadata and help text.
  • Current statistical values (count, minimum, maximum).
• Support for basic authentication to securely access protected Prometheus instances.

⚙️ Configuration

The server requires the following environment variables:

• PROMETHEUS_URL: The base URL of your Prometheus instance.

Optional authentication configuration:

• PROMETHEUS_USERNAME: Username for basic authentication (if required).
• PROMETHEUS_PASSWORD: Password for basic authentication (if required).

💻 Development

Install dependencies:

npm install

Build the server:

npm run build

Develop with automatic rebuild:

npm run watch

📦 Installation

To use with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-prometheus": {
      "command": "/path/to/mcp-server-prometheus/build/index.js",
      "env": {
        "PROMETHEUS_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

Debugging

Debugging can be challenging as MCP servers communicate via standard input and output. We recommend using MCP Inspector:

npm run inspector

The Inspector will provide a URL to access browser debugging tools.

📚 Documentation

API Structure

The server exposes Prometheus metrics through the following URI structure:

• Base URI: http://your-prometheus-instance:9090
• Metric URI: http://your-prometheus-instance:9090/metrics/{metric_name}

Each metric resource returns JSON data containing the following:

• Metric name.
• Metadata (help text, type).
• Current statistical information (count, minimum, maximum).