[{"_1":2,"_309":-5,"_310":-5},"loaderData",{"_3":4,"_24":25,"_219":220},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",27174307,"membership","referenceId","019ab2dc-db3f-72bd-9442-114d480ddb9a","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_28":-5,"_29":30,"_31":43,"_136":137,"_217":218},"availableLocales",[],"githubUser","locale",{"_31":32,"_39":40,"_41":42},"mcpServer",{"_33":34,"_35":36,"_37":38},"description","Provides seamless integration between AI assistants and Prometheus, enabling natural language interactions with your monitoring infrastructure. This server allows for effortless querying, discovery, and analysis of metrics.","displayName","prometheus-mcp","readme","

\n $\"Prometheus$
Prometheus MCP Server\n

\n\n

\n\n[![npm](https://img.shields.io/npm/v/prometheus-mcp?color=bright-green&logo=npm&logoColor=white&label=npm)](https://www.npmjs.com/package/prometheus-mcp) [![Docker](https://img.shields.io/badge/docker-ghcr.io-brightgreen?logo=docker&logoColor=white)](https://github.com/idanfishman/prometheus-mcp/pkgs/container/prometheus-mcp) [![codecov](https://img.shields.io/codecov/c/github/idanfishman/prometheus-mcp?color=brightgreen&logo=codecov&logoColor=white&label=coverage)](https://codecov.io/gh/idanfishman/prometheus-mcp) [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.19.0-brightgreen?logo=node.js&logoColor=white)](https://nodejs.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server that provides seamless integration between AI assistants and [Prometheus](https://prometheus.io/), enabling natural language interactions with your monitoring infrastructure. This server allows for effortless querying, discovery, and analysis of metrics through Visual Studio Code, Cursor, Windsurf, Claude Desktop, and other MCP clients.\n\n

\n\n## Key Features\n\n- **Fast and lightweight**. Direct API integration with Prometheus, no complex parsing needed.\n- **LLM-friendly**. Structured JSON responses optimized for AI assistant consumption.\n- **Configurable capabilities**. Enable/disable tool categories based on your security and operational requirements.\n- **Dual transport support**. Works with both stdio and HTTP transports for maximum compatibility.\n\n## Requirements\n\n- Node.js 20.19.0 or newer\n- Access to a Prometheus server\n- VS Code, Cursor, Windsurf, Claude Desktop or any other MCP client\n\n## Getting Started\n\nFirst, install the Prometheus MCP server with your client. A typical configuration looks like this:\n\n```json\n{\n \"mcpServers\": {\n \"prometheus\": {\n \"command\": \"npx\",\n \"args\": [\"prometheus-mcp@latest\", \"stdio\"],\n \"env\": {\n \"PROMETHEUS_URL\": \"http://localhost:9090\"\n }\n }\n }\n}\n```\n\n

Install in VS Code

\n\n```bash\n# For VS Code\ncode --add-mcp '{\"name\":\"prometheus\",\"command\":\"npx\",\"args\":[\"prometheus-mcp@latest\",\"stdio\"],\"env\":{\"PROMETHEUS_URL\":\"http://localhost:9090\"}}'\n\n# For VS Code Insiders\ncode-insiders --add-mcp '{\"name\":\"prometheus\",\"command\":\"npx\",\"args\":[\"prometheus-mcp@latest\",\"stdio\"],\"env\":{\"PROMETHEUS_URL\":\"http://localhost:9090\"}}'\n```\n\nAfter installation, the Prometheus MCP server will be available for use with your GitHub Copilot agent in VS Code.\n\n

\n\n

Install in Cursor

\n\nGo to `Cursor Settings` → `MCP` → `Add new MCP Server`. Name to your liking, use `command` type with the command `npx prometheus-mcp`. You can also verify config or add command arguments via clicking `Edit`.\n\n```json\n{\n \"mcpServers\": {\n \"prometheus\": {\n \"command\": \"npx\",\n \"args\": [\"prometheus-mcp@latest\", \"stdio\"],\n \"env\": {\n \"PROMETHEUS_URL\": \"http://localhost:9090\"\n }\n }\n }\n}\n```\n\n

\n\n

Install in Windsurf

\n\nFollow Windsurf MCP documentation. Use the following configuration:\n\n```json\n{\n \"mcpServers\": {\n \"prometheus\": {\n \"command\": \"npx\",\n \"args\": [\"prometheus-mcp@latest\", \"stdio\"],\n \"env\": {\n \"PROMETHEUS_URL\": \"http://localhost:9090\"\n }\n }\n }\n}\n```\n\n

\n\n

Install in Claude Desktop

\n\nClaude Desktop supports two installation methods:\n\n### Option 1: DXT Extension\n\nThe easiest way to install is using the pre-built DXT extension:\n\n1. Download the latest `.dxt` file from the [releases page](https://github.com/idanfishman/prometheus-mcp/releases)\n2. Double-click the downloaded file to install automatically\n3. Configure your Prometheus URL in the extension settings\n\n### Option 2: Developer Settings\n\nFor advanced users or custom configurations, manually configure the MCP server:\n\n1. Open Claude Desktop settings\n2. Navigate to the **Developer** section\n3. Add the following MCP server configuration:\n\n```json\n{\n \"mcpServers\": {\n \"prometheus\": {\n \"command\": \"npx\",\n \"args\": [\"prometheus-mcp@latest\", \"stdio\"],\n \"env\": {\n \"PROMETHEUS_URL\": \"http://localhost:9090\"\n }\n }\n }\n}\n```\n\n

\n \n## Configuration\n\nPrometheus MCP server supports the following arguments. They can be provided in the JSON configuration above, as part of the `\"args\"` list:\n\n```bash\n> npx prometheus-mcp@latest --help\n\nCommands:\n stdio Start Prometheus MCP server using stdio transport\n http Start Prometheus MCP server using HTTP transport\n\nOptions:\n --help Show help [boolean]\n --version Show version number [boolean]\n```\n\n### Environment Variables\n\nYou can also configure the server using environment variables:\n\n- `PROMETHEUS_URL` - Prometheus server URL\n- `ENABLE_DISCOVERY_TOOLS` - Set to \"false\" to disable discovery tools (default: true)\n- `ENABLE_INFO_TOOLS` - Set to \"false\" to disable info tools (default: true)\n- `ENABLE_QUERY_TOOLS` - Set to \"false\" to disable query tools (default: true)\n\n## Standalone MCP Server\n\nWhen running in server environments or when you need HTTP transport, run the MCP server with the `http` command:\n\n```bash\nnpx prometheus-mcp@latest http --port 3000\n```\n\nAnd then in your MCP client config, set the `url` to the HTTP endpoint:\n\n```json\n{\n \"mcpServers\": {\n \"prometheus\": {\n \"command\": \"npx\",\n \"args\": [\"mcp-remote\", \"http://localhost:3000/mcp\"]\n }\n }\n}\n```\n\n## Docker\n\nRun the Prometheus MCP server using Docker:\n\n```json\n{\n \"mcpServers\": {\n \"prometheus\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"--init\",\n \"--pull=always\",\n \"-e\",\n \"PROMETHEUS_URL=http://host.docker.internal:9090\",\n \"ghcr.io/idanfishman/prometheus-mcp\",\n \"stdio\"\n ]\n }\n }\n}\n```\n\n## Tools\n\nThe Prometheus MCP server provides 10 tools organized into three configurable categories:\n\n

Discovery

\n\nTools for exploring your Prometheus infrastructure:\n\n- **`prometheus_list_metrics`**\n - **Description**: List all available Prometheus metrics\n - **Parameters**: None\n - **Read-only**: **true**\n\n- **`prometheus_metric_metadata`**\n - **Description**: Get metadata for a specific Prometheus metric\n - **Parameters**:\n - `metric` (string): Metric name to get metadata for\n - **Read-only**: **true**\n\n- **`prometheus_list_labels`**\n - **Description**: List all available Prometheus labels\n - **Parameters**: None\n - **Read-only**: **true**\n\n- **`prometheus_label_values`**\n - **Description**: Get all values for a specific Prometheus label\n - **Parameters**:\n - `label` (string): Label name to get values for\n - **Read-only**: **true**\n\n- **`prometheus_list_targets`**\n - **Description**: List all Prometheus scrape targets\n - **Parameters**: None\n - **Read-only**: **true**\n\n- **`prometheus_scrape_pool_targets`**\n - **Description**: Get targets for a specific scrape pool\n - **Parameters**:\n - `scrapePool` (string): Scrape pool name\n - **Read-only**: **true**\n\n

\n\n

Info

\n\nTools for accessing Prometheus server information:\n\n- **`prometheus_runtime_info`**\n - **Description**: Get Prometheus runtime information\n - **Parameters**: None\n - **Read-only**: **true**\n\n- **`prometheus_build_info`**\n - **Description**: Get Prometheus build information\n - **Parameters**: None\n - **Read-only**: **true**\n\n

\n\n

Query

\n\nTools for executing Prometheus queries:\n\n- **`prometheus_query`**\n - **Description**: Execute an instant Prometheus query\n - **Parameters**:\n - `query` (string): Prometheus query expression\n - `time` (string, optional): Time parameter for the query (RFC3339 format)\n - **Read-only**: **true**\n\n- **`prometheus_query_range`**\n - **Description**: Execute a Prometheus range query\n - **Parameters**:\n - `query` (string): Prometheus query expression\n - `start` (string): Start timestamp (RFC3339 or unix timestamp)\n - `end` (string): End timestamp (RFC3339 or unix timestamp)\n - `step` (string): Query resolution step width\n - **Read-only**: **true**\n\n

\n\n## Example Usage\n\nHere are some example interactions you can have with your AI assistant:\n\n### Basic Queries\n\n- \"Show me all available metrics in Prometheus\"\n- \"What's the current CPU usage across all instances?\"\n- \"Get the memory usage for the last hour\"\n\n### Discovery and Exploration\n\n- \"List all scrape targets and their status\"\n- \"What labels are available for the `http_requests_total` metric?\"\n- \"Show me all metrics related to 'cpu'\"\n\n### Advanced Analysis\n\n- \"Compare CPU usage between production and staging environments\"\n- \"Show me the top 10 services by memory consumption\"\n- \"What's the error rate trend for the API service over the last 24 hours?\"\n\n## Security Considerations\n\n- **Network Access**: The server requires network access to your Prometheus instance\n- **Resource Usage**: Range queries can be resource-intensive; monitor your Prometheus server load\n\n## Troubleshooting\n\n### Connection Issues\n\n- Verify your Prometheus server is accessible at the configured URL\n- Check firewall settings and network connectivity\n- Ensure Prometheus API is enabled (default on port 9090)\n\n### Permission Errors\n\n- Verify the MCP server has network access to Prometheus\n- Check if authentication is required for your Prometheus setup\n\n### Tool Availability\n\n- If certain tools are missing, check if they've been disabled via configuration\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\n- **GitHub Issues**: [Report bugs or request features](https://github.com/idanfishman/prometheus-mcp/issues)\n- **Documentation**: [Model Context Protocol Documentation](https://modelcontextprotocol.io/)\n- **Prometheus**: [Prometheus Documentation](https://prometheus.io/docs/)\n\nBuilt with ❤️ for the Prometheus and MCP communities\n","name","English","tag","en-US",{"_44":45,"_13":46,"_55":34,"_56":34,"_35":36,"_16":57,"_58":59,"_78":79,"_86":-5,"_87":88,"_89":-5,"_90":91,"_124":125,"_130":-5,"_66":36,"_131":132,"_69":133,"_134":135},"addedAt","2025-07-01T19:54:58.072901Z",[47,48,49,50,51,52,53,54],"category:monitoring","category:observability","environment:network","hosting:hybrid","language:typescript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","descriptionPlainText",8662,"integrations",[60,71],{"_61":62,"_33":68,"_69":70},"brand",{"_63":64,"_39":65,"_66":67},"logoSvgPath","M23.922 16.997C23.061 18.492 18.063 22.02 12 22.02 5.937 22.02.939 18.492.078 16.997A.641.641 0 0 1 0 16.741v-2.869a.883.883 0 0 1 .053-.22c.372-.935 1.347-2.292 2.605-2.656.167-.429.414-1.055.644-1.517a10.098 10.098 0 0 1-.052-1.086c0-1.331.282-2.499 1.132-3.368.397-.406.89-.717 1.474-.952C7.255 2.937 9.248 1.98 11.978 1.98c2.731 0 4.767.957 6.166 2.093.584.235 1.077.546 1.474.952.85.869 1.132 2.037 1.132 3.368 0 .368-.014.733-.052 1.086.23.462.477 1.088.644 1.517 1.258.364 2.233 1.721 2.605 2.656a.841.841 0 0 1 .053.22v2.869a.641.641 0 0 1-.078.256Zm-11.75-5.992h-.344a4.359 4.359 0 0 1-.355.508c-.77.947-1.918 1.492-3.508 1.492-1.725 0-2.989-.359-3.782-1.259a2.137 2.137 0 0 1-.085-.104L4 11.746v6.585c1.435.779 4.514 2.179 8 2.179 3.486 0 6.565-1.4 8-2.179v-6.585l-.098-.104s-.033.045-.085.104c-.793.9-2.057 1.259-3.782 1.259-1.59 0-2.738-.545-3.508-1.492a4.359 4.359 0 0 1-.355-.508Zm2.328 3.25c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm-5 0c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm3.313-6.185c.136 1.057.403 1.913.878 2.497.442.544 1.134.938 2.344.938 1.573 0 2.292-.337 2.657-.751.384-.435.558-1.15.558-2.361 0-1.14-.243-1.847-.705-2.319-.477-.488-1.319-.862-2.824-1.025-1.487-.161-2.192.138-2.533.529-.269.307-.437.808-.438 1.578v.021c0 .265.021.562.063.893Zm-1.626 0c.042-.331.063-.628.063-.894v-.02c-.001-.77-.169-1.271-.438-1.578-.341-.391-1.046-.69-2.533-.529-1.505.163-2.347.537-2.824 1.025-.462.472-.705 1.179-.705 2.319 0 1.211.175 1.926.558 2.361.365.414 1.084.751 2.657.751 1.21 0 1.902-.394 2.344-.938.475-.584.742-1.44.878-2.497Z","GitHub Copilot","slug","github-copilot","Integrates with GitHub Copilot in VS Code, allowing AI agents to access and analyze Prometheus monitoring data through natural language interactions.","uid","t2qwm8qg0d",{"_61":72,"_33":76,"_69":77},{"_63":73,"_39":74,"_66":75},"M12 0C5.373 0 0 5.372 0 12c0 6.627 5.373 12 12 12s12-5.373 12-12c0-6.628-5.373-12-12-12zm0 22.46c-1.885 0-3.414-1.26-3.414-2.814h6.828c0 1.553-1.528 2.813-3.414 2.813zm5.64-3.745H6.36v-2.046h11.28v2.046zm-.04-3.098H6.391c-.037-.043-.075-.086-.111-.13-1.155-1.401-1.427-2.133-1.69-2.879-.005-.025 1.4.287 2.395.511 0 0 .513.119 1.262.255-.72-.843-1.147-1.915-1.147-3.01 0-2.406 1.845-4.508 1.18-6.207.648.053 1.34 1.367 1.387 3.422.689-.951.977-2.69.977-3.755 0-1.103.727-2.385 1.454-2.429-.648 1.069.168 1.984.894 4.256.272.854.237 2.29.447 3.201.07-1.892.395-4.652 1.595-5.605-.529 1.2.079 2.702.494 3.424.671 1.164 1.078 2.047 1.078 3.716a4.642 4.642 0 01-1.11 2.996c.792-.149 1.34-.283 1.34-.283l2.573-.502s-.374 1.538-1.81 3.019z","Prometheus","prometheus","Enables natural language querying and analysis of Prometheus metrics, with tools for metric discovery, label exploration, target inspection, and executing both instant and range queries against a Prometheus monitoring server.","8e91ylysn7","namespace",{"_80":81,"_66":85},"owner",{"_82":83},"githubAccount",{"_84":85},"login","idanfishman","readmeMarkdown","recentUsage",0,"redditPostExternalId","repository",{"_92":-5,"_93":94,"_97":98,"_116":-5,"_117":118,"_119":120,"_123":-5},"argumentsJsonSchema","githubProject",{"_37":38,"_95":96},"url","https://github.com/idanfishman/prometheus-mcp","githubRepository",{"_99":100,"_101":102,"_103":104,"_16":105,"_106":107,"_39":36,"_80":108,"_110":88,"_111":112,"_114":115},"defaultBranch","master","fullName","idanfishman/prometheus-mcp","githubTreeId",350080,18368,"language","TypeScript",{"_84":85,"_69":109},"wlhlak3l0h","recentStargazers","spdxLicense",{"_39":113},"MIT License","stargazers",22,"glamaJson","inspectable",true,"npmPackage",{"_39":36,"_121":122},"weeklyDownloads",61,"supportedPlatforms","scores",{"_126":127,"_128":127,"_129":127},"license",100,"quality","security","simpleIcon","toolCount",10,"cbuatpob5k","updatedAt","2025-11-23T04:10:57.197333Z","meta",[138,141,143,150,153,155,158,161,164,167,170,172,175,178,180,182,184,186,188],{"_139":140},"title","prometheus-mcp | Glama",{"_142":34,"_39":33},"content",{"_144":145,"_146":147,"_148":149},"href","https://glama.ai/mcp/servers/@idanfishman/prometheus-mcp","rel","canonical","tagName","link",{"_142":36,"_151":152},"property","og:title",{"_142":34,"_151":154},"og:description",{"_142":156,"_151":157},"https://glama.ai/logo.png","og:logo",{"_142":159,"_151":160},"https://glama.ai/mcp/servers/@idanfishman/prometheus-mcp/og-image","og:image",{"_142":162,"_151":163},"630","og:image:height",{"_142":165,"_151":166},"1200","og:image:width",{"_142":168,"_151":169},"website","og:type",{"_142":145,"_151":171},"og:url",{"_142":173,"_151":174},"Glama – MCP Hosting Platform","og:site_name",{"_142":176,"_39":177},"summary_large_image","twitter:card",{"_142":173,"_39":179},"twitter:title",{"_142":34,"_39":181},"twitter:description",{"_142":159,"_39":183},"twitter:image",{"_142":162,"_39":185},"twitter:image:height",{"_142":165,"_39":187},"twitter:image:width",{"_189":190},"script:ld+json",{"_191":192,"_193":194},"@context","http://schema.org","@graph",[195],{"_191":196,"_197":198,"_199":200},"https://schema.org","@type","BreadcrumbList","itemListElement",[201,208,211,215],{"_197":202,"_203":204,"_39":205,"_206":207},"ListItem","item","https://glama.ai/","Glama","position",1,{"_197":202,"_203":209,"_39":210,"_206":22},"https://glama.ai/mcp","MCP",{"_197":202,"_203":212,"_39":213,"_206":214},"https://glama.ai/mcp/servers","Servers",3,{"_197":202,"_203":145,"_39":36,"_206":216},4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_221":222,"_31":228,"_245":246,"_136":260,"_257":284,"_285":286},"blob",{"_142":223,"_224":225,"_226":227},"import dotenv from \"dotenv\";\nimport { cmd } from \"./cmd/cmd\";\n\ndotenv.config({ quiet: true });\ncmd();\n","fileName","index.ts","size",102,{"_44":45,"_13":229,"_55":34,"_56":34,"_35":36,"_16":57,"_58":230,"_78":235,"_86":-5,"_87":88,"_89":-5,"_90":238,"_124":244,"_130":-5,"_66":36,"_131":132,"_69":133,"_134":135},[47,48,49,50,51,52,53,54],[231,233],{"_61":232,"_33":68,"_69":70},{"_63":64,"_39":65,"_66":67},{"_61":234,"_33":76,"_69":77},{"_63":73,"_39":74,"_66":75},{"_80":236,"_66":85},{"_82":237},{"_84":85},{"_92":-5,"_93":239,"_97":240,"_116":-5,"_117":118,"_119":243,"_123":-5},{"_37":38,"_95":96},{"_99":100,"_101":102,"_103":104,"_16":105,"_106":107,"_39":36,"_80":241,"_110":88,"_111":242,"_114":115},{"_84":85,"_69":109},{"_39":113},{"_39":36,"_121":122},{"_126":127,"_128":127,"_129":127},"member",{"_247":248,"_251":252,"_253":254,"_103":255,"_256":218,"_257":225,"_258":118,"_226":227,"_259":221},"commit",{"_249":250},"sha","87bc8ad2ccdd008c9b40127767feb3542fc94c73","contentStoredObjectPointerId",391924,"fullPath","src/index.ts",350079,"indexable","path","safeToDisplayAsText","type",[261,263,265,267,269,270,271,273,274,275,276,277,278,279,280,281,282,283],{"_139":262},"index.ts | prometheus-mcp | Glama",{"_142":264,"_39":33},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_144":266,"_146":147,"_148":149},"https://glama.ai/mcp/servers/@idanfishman/prometheus-mcp/blob/87bc8ad2ccdd008c9b40127767feb3542fc94c73/src",{"_142":268,"_151":152},"index.ts | prometheus-mcp",{"_142":264,"_151":154},{"_142":156,"_151":157},{"_142":272,"_151":160},"https://glama.ai/generated-images/og?title=index.ts+%7C+prometheus-mcp",{"_142":162,"_151":163},{"_142":165,"_151":166},{"_142":168,"_151":169},{"_142":266,"_151":171},{"_142":173,"_151":174},{"_142":176,"_39":177},{"_142":173,"_39":179},{"_142":264,"_39":181},{"_142":272,"_39":183},{"_142":162,"_39":185},{"_142":165,"_39":187},"src","treeMembers",[287,292,296,299,303,307],{"_247":288,"_253":289,"_257":290,"_259":291},{"_249":250},"src/cmd","cmd","tree",{"_247":293,"_253":294,"_257":295,"_259":291},{"_249":250},"src/logging","logging",{"_247":297,"_253":298,"_257":75,"_259":291},{"_249":250},"src/prometheus",{"_247":300,"_253":301,"_257":302,"_259":291},{"_249":250},"src/server","server",{"_247":304,"_253":305,"_257":306,"_259":291},{"_249":250},"src/types","types",{"_247":308,"_253":254,"_257":225,"_259":221},{"_249":250},"actionData","errors"]

\n Prometheus MCP Server\n

\n $\"Prometheus$
Prometheus MCP Server\n

MCP directory API