Overview
The mcp-server-prometheus is a TypeScript-based MCP server designed to interact with Prometheus metrics and data using the Model Context Protocol (MCP). This server acts as a bridge between Claude and your Prometheus server.
To use this server, configure it with your Prometheus instance URL and set up optional authentication. Add the server configuration to Claude Desktop for integration.
- Lists and accesses Prometheus metric schema. - Provides detailed metadata and current statistical information for metrics (count, min, max). - Supports basic authentication for secured Prometheus instances. - Exposes Prometheus metrics through a structured API.
- Monitoring and retrieving metrics from Prometheus for analytics.
- Integrating Prometheus data with Claude applications for enhanced functionality.
- Providing an interactive interface to explore Prometheus metrics and their metadata.
Add to your AI client
Use these steps to connect mcp-server-prometheus in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-prometheus-loglmhq": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-prometheus-loglmhq"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-prometheus-loglmhq": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-prometheus-loglmhq"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-prometheus-loglmhq": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-prometheus-loglmhq"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-prometheus-loglmhq": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-prometheus-loglmhq"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-prometheus-loglmhq": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-prometheus-loglmhq"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-prometheus-loglmhq": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-prometheus-loglmhq"
]
}
}
}FAQ
What is the required configuration for mcp-server-prometheus?
Set the `PROMETHEUS_URL` environment variable to the base URL of your Prometheus instance, and optionally provide authentication.
Can I use mcp-server-prometheus without a Prometheus instance?
No, the server requires a connected Prometheus instance to function correctly.
How can I debug the server?
You can use the MCP Inspector for debugging; it provides tools to simplify the debugging process.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":279,"uuid":"858fc918-ff91-4c04-bf72-0457faf3544e","name":"mcp-server-prometheus","title":"mcp-server-prometheus","description":"MCP server for interacting with Prometheus","avatar_url":"https://avatars.githubusercontent.com/u/190804255?v=4","created_at":"2024-12-13T10:44:30.333Z","updated_at":"2024-12-13T12:28:11.319Z","status":"created","author_name":"loglmhq","author_avatar_url":"https://avatars.githubusercontent.com/u/190804255?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/loglmhq/mcp-server-prometheus","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/loglmhq/mcp-server-prometheus/raw/main/demo.png","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]