MCP Prometheus Server
@drewstreib
About MCP Prometheus Server
A sophisticated MCP server for Prometheus queries demonstrating advanced Haskell practices
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-prom-haskell": {
"command": "docker",
"args": [
"build",
"-t",
"mcp-prometheus-server",
"."
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Prometheus Server?
A production-ready Model Context Protocol (MCP) server implementation in Haskell that provides Claude Desktop with access to Prometheus metrics and queries. It offers five tools for querying, discovering, and exploring Prometheus metrics, built with strict exception handling and thread-safe patterns.
How to use MCP Prometheus Server?
Install using the pre-built binary, build from source with GHC 9.12+ and Cabal, or run via Docker. Configure Claude Desktop by adding an entry in claude_desktop_config.json pointing to the server binary with the --prometheus-url argument pointing to your Prometheus instance.
Key features of MCP Prometheus Server
- Seamless Claude Desktop integration via MCP protocol
- Five tools: query, query range, series, metrics, labels
- Production-ready error handling and logging
- Thread-safe execution with strict evaluation
- Pre-built binary, source build, and Docker options
- Comprehensive test suite with unit and integration tests
- BSD 3-Clause open source license
Use cases of MCP Prometheus Server
- Ask Claude "What's the current CPU usage?" using instant PromQL queries
- Visualize memory usage trends over the last hour with range queries
- Discover available metric names in your Prometheus instance
- Find time series matching specific label selectors
- Explore all label names used across metrics for filtering
FAQ from MCP Prometheus Server
What dependencies are required to build from source?
GHC 9.12+ and Cabal 3.0+ are required; GHCup is recommended for installation.
How do I configure the Prometheus server URL?
Set the PROMETHEUS_URL environment variable or use the --prometheus-url command-line option (default: http://your-prometheus-server:9090).
What should I do if the Docker container exits immediately?
The MCP server expects stdio interaction; use the -it flags when running the container.
Can I connect to a Prometheus server on a different network with Docker?
Yes, ensure both containers are on the same Docker network by using --network flags.
Is the server compatible with JSON-RPC notifications?
Yes, it properly handles notifications without returning responses per the JSON-RPC specification.
Frequently asked questions
What dependencies are required to build from source?
GHC 9.12+ and Cabal 3.0+ are required; GHCup is recommended for installation.
How do I configure the Prometheus server URL?
Set the `PROMETHEUS_URL` environment variable or use the `--prometheus-url` command-line option (default: `http://your-prometheus-server:9090`).
What should I do if the Docker container exits immediately?
The MCP server expects stdio interaction; use the `-it` flags when running the container.
Can I connect to a Prometheus server on a different network with Docker?
Yes, ensure both containers are on the same Docker network by using `--network` flags.
Is the server compatible with JSON-RPC notifications?
Yes, it properly handles notifications without returning responses per the JSON-RPC specification.
Basic information
More Developer Tools MCP servers
PuzzleTide Puzzle Generator
Caravaca-LabsWord search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers
Grafana MCP server
grafanaMCP server for Grafana
Hello World MCP Server (Reference Extension)
anthropicsDesktop Extensions: One-click local MCP server installation in desktop apps
Unity MCP (Server + Plugin)
IvanMurzakAI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr
BetterBugs
BetterBugsThe BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C
Comments