mcpField
P
Prometheus MCP Server

Prometheus MCP Server

Local
github.com/kakao-yanoo-kimDeveloper Tools1Updated 78w ago
Repository

About Prometheus MCP Server

Prometheus MCP Server provides MCP access to data from a Prometheus server. It is for users who need to access Prometheus through MCP, with optional authentication and organization settings.

Key features

  1. 01Connect to a Prometheus server
  2. 02Authenticate with username and password
  3. 03Authenticate with a token
  4. 04Set organization ID
  5. 05Configure timeout and series limit

Use cases

  1. 01Access Prometheus data from an MCP client
  2. 02Connect using basic authentication
  3. 03Set limits for query evaluation results

MCP support

The server gives MCP clients access to Prometheus data; connection details and optional authentication are set through command-line arguments.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "prometheus-mcp-server-py": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Prometheus MCP Server

smithery badge

A tool that allows access to Prometheus data through a Model Context Protocol server.

Installation

Installing via Smithery

To install Prometheus Data Access Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kakao-yanoo-kim/prometheus-mcp-server-py --client claude
Manual Installation
pipx install git+https://github.com/kakao-yanoo-kim/prometheus-mcp-server-py.git
Run Without Installation

You can also run the package directly without installing it using pipx run:

pipx run --spec git+https://github.com/kakao-yanoo-kim/prometheus-mcp-server-py.git prometheus-mcp --url http://your-prometheus-server:9090

This is useful for testing or one-time usage scenarios.

Usage

# Command line arguments
prometheus-mcp --url http://your-prometheus-server:9090 \
  --username username \
  --password password
# Or
prometheus-mcp --url http://your-prometheus-server:9090 \
  --token your-token

Command Line Arguments

  • --url: Prometheus server URL (required)
  • --username: Username for basic authentication (optional)
  • --password: Password for basic authentication (optional)
  • --token: Token for authentication (optional)
  • --org-id: Organization ID for multi-tenant setups (optional)
  • --timeout: Evaluation timeout in seconds (default: 30)
  • --limit: Maximum number of returned series (default: 1000)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.