InfluxDB MCP Server

InfluxDB MCP 서버

InfluxDB OSS API v2를 사용하여 InfluxDB 인스턴스에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 대부분 Claude Code로 구축되었습니다.

특징

이 MCP 서버는 다음을 제공합니다.

• 리소스 : 조직, 버킷 및 측정 데이터에 대한 액세스
• 도구 : 데이터 쓰기, 쿼리 실행, 데이터베이스 객체 관리
• 프롬프트 : 일반적인 Flux 쿼리 및 라인 프로토콜 형식에 대한 템플릿

자원

서버는 다음과 같은 리소스를 제공합니다.

1. 조직 목록 : influxdb://orgs
   • InfluxDB 인스턴스의 모든 조직을 표시합니다.
2. 버킷 리스트 : influxdb://buckets
   • 모든 버킷을 메타데이터와 함께 표시합니다.
3. 버킷 측정 : influxdb://bucket/{bucketName}/measurements
   • 지정된 버킷 내의 모든 측정값을 나열합니다.
4. 쿼리 데이터 : influxdb://query/{orgName}/{fluxQuery}
   • Flux 쿼리를 실행하고 결과를 리소스로 반환합니다.

도구

서버는 다음과 같은 도구를 제공합니다.

1. write-data : 라인 프로토콜 형식으로 시계열 데이터를 씁니다.
   • 매개변수: org, bucket, data, precision(선택 사항)
2. query-data : Flux 쿼리 실행
   • 매개변수: org, 쿼리
3. create-bucket : 새로운 버킷을 생성합니다
   • 매개변수: name, orgID, retentionPeriodSeconds(선택 사항)
4. create-org : 새로운 조직을 만듭니다
   • 매개변수: 이름, 설명(선택 사항)

프롬프트

서버는 다음과 같은 프롬프트 템플릿을 제공합니다.

1. flux-query-examples : 일반적인 Flux 쿼리 예시
2. line-protocol-guide : InfluxDB 라인 프로토콜 형식 가이드

구성

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

• INFLUXDB_TOKEN (필수): InfluxDB API에 대한 인증 토큰
• INFLUXDB_URL (선택 사항): InfluxDB 인스턴스의 URL(기본값은 http://localhost:8086 )
• INFLUXDB_ORG (선택 사항): 특정 작업에 대한 기본 조직 이름

설치

Smithery를 통해 설치

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

지엑스피1

옵션 1: npx로 실행(권장)

옵션 2: 글로벌 설치

옵션 3: 소스에서

데스크톱용 Claude와 통합

claude_desktop_config.json 에 서버를 추가합니다.

npx 사용(권장)

로컬로 설치된 경우

코드 구조

서버 코드는 모듈형 구조로 구성됩니다.

• src/
  • index.js - 메인 서버 진입점
  • config/ - 구성 관련 파일
    • env.js - 환경 변수 처리
  • utils/ - 유틸리티 함수
    • influxClient.js - InfluxDB API 클라이언트
    • loggerConfig.js - 콘솔 로거 구성
  • handlers/ - 리소스 및 도구 핸들러
    • organizationsHandler.js - 조직 목록
    • bucketsHandler.js - 버킷 목록
    • measurementsHandler.js - 측정 목록
    • queryHandler.js - 쿼리 실행
    • writeDataTool.js - 데이터 쓰기 도구
    • queryDataTool.js - 쿼리 도구
    • createBucketTool.js - 버킷 생성 도구
    • createOrgTool.js - 조직 생성 도구
  • prompts/ - 프롬프트 템플릿
    • fluxQueryExamplesPrompt.js - Flux 쿼리 예제
    • lineProtocolGuidePrompt.js - 라인 프로토콜 가이드

이러한 구조는 더 나은 유지 관리, 더 쉬운 테스트, 그리고 더 명확한 관심사 분리를 가능하게 합니다.

테스트

저장소에는 다음과 같은 포괄적인 통합 테스트가 포함되어 있습니다.

• InfluxDB로 Docker 컨테이너를 시작하세요
• 샘플 데이터로 채우세요
• 모든 MCP 서버 기능 테스트

테스트를 실행하려면:

특허

MIT