mcp-서버-프로메테우스

Prometheus 메트릭 및 데이터와 상호 작용하기 위한 MCP 서버입니다.

Prometheus API 인터페이스를 구현하는 TypeScript 기반 MCP 서버입니다. 모델 컨텍스트 프로토콜(MCP)을 통해 Claude와 Prometheus 서버 간의 연결을 제공합니다.

데모

특징

자원

• Prometheus 메트릭 스키마 나열 및 액세스
• 각 메트릭 리소스는 다음을 제공합니다.
  • 메트릭 이름 및 설명
  • Prometheus의 자세한 메타데이터
  • 통계 정보(개수, 최소값, 최대값)
• 구조화된 데이터 액세스를 위한 JSON MIME 유형

현재 역량

• 사용 가능한 모든 Prometheus 메트릭을 설명과 함께 나열합니다.
• 다음을 포함한 자세한 메트릭 정보를 읽어보세요.
  • 메타데이터 및 도움말 텍스트
  • 현재 통계 데이터(개수, 최소값, 최대값)
• 보안된 Prometheus 인스턴스에 대한 기본 인증 지원

구성

서버에는 다음 환경 변수가 필요합니다.

• PROMETHEUS_URL : Prometheus 인스턴스의 기본 URL

선택적 인증 구성:

• PROMETHEUS_USERNAME : 기본 인증을 위한 사용자 이름(필요한 경우)
• PROMETHEUS_PASSWORD : 기본 인증을 위한 비밀번호(필요한 경우)

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 사용을 권장합니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

API 구조

서버는 다음 URI 구조를 통해 Prometheus 메트릭을 노출합니다.

• 기본 URI: http://your-prometheus-instance:9090
• 메트릭 URI: http://your-prometheus-instance:9090/metrics/{metric_name}

각 메트릭 리소스는 다음을 포함하는 JSON 데이터를 반환합니다.

• 메트릭 이름
• 메타데이터(도움말 텍스트, 유형)
• 현재 통계(개수, 최소값, 최대값)