Prometheus
About
Integrates with Prometheus to query and analyze time-series metrics data for real-time system monitoring and performance insights.
Details
- Author
- caesaryangs
- Repository
- CaesarYangs/prometheus_mcp_server
- GitHub stars
- 25
- License
- MIT License
- Categories
- Database, Infrastructure, Other, Productivity, Developer Tools, Design, AI, Search, Frontend, Project Management, API
- Tags
- #analytics
Jump to
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PrometheusCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
/path/to/prometheus_mcp_server -
Argument 3
run -
Argument 4
server.py
Environment-
PROMETHEUS_HOST
http://localhost:9090
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install Prometheus MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @CaesarYangs/prometheus_mcp_server --client claude
Prepare python env
cd ./src/prometheus_mcp_server
python3 -m venv .venv
```sh
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"prometheus": {
"env": {
"PROMETHEUS_HOST": "http://localhost:9090"
},
"args": [
"--directory",
"/path/to/prometheus_mcp_server",
"run",
"server.py"
],
"command": "uv"
}
}
}Linux
{
"env": {
"PROMETHEUS_HOST": "http://localhost:9090"
},
"args": [
"--directory",
"/path/to/prometheus_mcp_server",
"run",
"server.py"
],
"command": "uv"
}Macos
{
"env": {
"PROMETHEUS_HOST": "http://localhost:9090"
},
"args": [
"--directory",
"/path/to/prometheus_mcp_server",
"run",
"server.py"
],
"command": "uv"
}Windows
{
"env": {
"PROMETHEUS_HOST": "http://localhost:9090"
},
"args": [
"--directory",
"/path/to/prometheus_mcp_server",
"run",
"server.py"
],
"command": "uv"
}MCP Server for Prometheus
A Model Context Protocol (MCP) server for retrieving data from Prometheus databases. This MCP server enables Large Language Models (LLMs) to invoke tool functions that retrieve and analyze vast amounts of metric data, search metric usage, execute complex queries, and perform other related tasks through pre-defined routes with enhanced control over usage.
- Data Retrieval: Fetch specific metrics or ranges of data from Prometheus.
- Metric Analysis: Perform statistical analysis on retrieved metrics.
- Usage Search: Find and explore metric usage patterns.
- Complex Querying: Execute advanced PromQL queries for in-depth data exploration.
Capibilites
✅ Retrieve comprehensive metric information, including names and descriptions, from Prometheus
✅ Fetch and analyze specific metric data using metric names
✅ Analyze metric data within custom time ranges
🚧 Filter and match data using specific labels (in development)
⏳ Additional features planned...
Getting Started
MCP runing requires a python virtual environment(venv), all packages should be installed into this venv so the MCP server can be automically started.
Installing via Smithery
To install Prometheus MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @CaesarYangs/prometheus_mcp_server --client claude
Manual Installation
Prepare python envcd ./src/prometheus_mcp_server
python3 -m venv .venv
```sh
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
