Prometheus MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Enables data retrieval and analysis from Prometheus databases, including fetching specific metrics, performing statistical analysis, searching metric usage patterns, and executing complex PromQL queries for in-depth data exploration.

Prometheus용 MCP 서버

Prometheus 데이터베이스에서 데이터를 검색하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP 서버를 통해 대용량 언어 모델(LLM)은 방대한 양의 메트릭 데이터를 검색 및 분석하고, 메트릭 사용량을 검색하고, 복잡한 쿼리를 실행하고, 향상된 사용 제어 기능을 갖춘 사전 정의된 경로를 통해 기타 관련 작업을 수행하는 도구 함수를 호출할 수 있습니다.

  • 데이터 검색: Prometheus에서 특정 메트릭이나 데이터 범위를 가져옵니다.
  • 지표 분석: 검색된 지표에 대한 통계 분석을 수행합니다.
  • 사용 검색: 메트릭 사용 패턴을 찾아 살펴보세요.
  • 복잡한 쿼리: 심층적인 데이터 탐색을 위해 고급 PromQL 쿼리를 실행합니다.

카피빌리테스

✅ Prometheus에서 이름과 설명을 포함한 포괄적인 메트릭 정보를 검색합니다.

✅ 메트릭 이름을 사용하여 특정 메트릭 데이터를 가져오고 분석합니다.

✅ 사용자 정의 시간 범위 내에서 메트릭 데이터 분석

🚧 특정 레이블을 사용하여 데이터 필터링 및 일치(개발 중)

⏳ 추가 기능이 계획되어 있습니다...

시작하기

MCP를 실행하려면 Python 가상 환경(venv)이 필요하며, 모든 패키지는 이 venv에 설치해야 MCP 서버가 자동으로 시작됩니다.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Prometheus MCP 서버를 자동으로 설치하려면:

지엑스피1

수동 설치

파이썬 환경 준비

cd ./src/prometheus_mcp_server python3 -m venv .venv
# linux/macos: source .venv/bin/activate # windows: .venv\Scripts\activate

이제 전용 Python 환경으로 사용할 준비가 되었습니다.

필요한 패키지를 설치하세요

pip가 제대로 설치되었는지 확인하세요. pip 없이 venv가 설치된 경우, 다음 명령어를 사용하여 수동으로 설치하세요.

wget https://bootstrap.pypa.io/get-pip.py python3 get-pip.py

그런 다음 필요한 모든 패키지를 설치하세요.

pip install -r requirements.txt

용법

커서 Env 포함

더욱 사용하기 쉬운 커서 환경에 따라 업데이트할 준비가 되었습니다.

커서 설정의 MCP 섹션에서 다음을 설정합니다.

uv --directory /path/to/prometheus_mcp_server run server.py

MCP 클라이언트(Claude Desktop 포함) 사용

~/Library/Application Support/Claude/claude_desktop_config.json (macOS)에서 Claude Desktop 앱의 구성을 구성하세요.

{ "mcpServers": { "prometheus": { "command": "uv", "args": [ "--directory", "/path/to/prometheus_mcp_server", "run", "server.py" ], "env": { "PROMETHEUS_HOST": "http://localhost:9090" } } } }

독립형 MCP 서버

이 MCP 서버를 혼자 시작했습니다.

자외선 방법

uv --directory /path/to/prometheus_mcp_server run server.py

이는 Claude Desktop이 앱이 시작될 때 이 UX 스크립트 방식을 사용하여 MCP 서버가 자동으로 시작될 수 있도록 하는 방법이기도 합니다.

일반 파이썬 메서드

python3 server.py

기여하다

참여를 환영합니다! 간단한 가이드를 소개합니다.

  1. 저장소를 포크하세요
  2. 기능 브랜치를 생성합니다( git checkout -b feature/AmazingFeature )
  3. 변경 사항을 커밋합니다( git commit -m 'Add some AmazingFeature' )
  4. 브랜치에 푸시( git push origin feature/AmazingFeature )
  5. 풀 리퀘스트 열기

중요한 변경 사항이 있는 경우, 먼저 이슈를 열어서 변경하고 싶은 사항을 논의하세요.

귀하의 기여에 감사드립니다!

특허

MIT 라이센스

참고문헌 및 감사의 글

이 프로젝트는 다음 오픈 소스 프로젝트에서 영감을 얻었거나 해당 프로젝트의 코드를 사용합니다.

-
security - not tested
A
license - permissive license
-
quality - not tested

사전 정의된 경로를 통해 대규모 언어 모델이 Prometheus 데이터베이스에서 메트릭 데이터를 검색, 분석 및 쿼리할 수 있도록 하는 MCP 서버입니다.

  1. Capibilites
    1. Getting Started
      1. Installing via Smithery
      2. Manual Installation
    2. Usage
      1. With Cursor Env
      2. With MCP Client(include Claude Desktop)
      3. Standalone MCP Server
    3. Contributing
      1. License
        1. References & Acknowledgments
          ID: nswv189shn