IoTDB MCP Server

IoTDB MCP 서버

개요

IoTDB를 통해 데이터베이스 상호작용 및 비즈니스 인텔리전스 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 SQL 쿼리를 실행할 수 있습니다.

구성 요소

자원

서버는 어떤 리소스도 노출하지 않습니다.

프롬프트

서버는 어떠한 프롬프트도 제공하지 않습니다.

도구

이 서버는 IoTDB 트리 모델과 테이블 모델에 대한 다양한 도구를 제공합니다. "IOTDB_SQL_DIALECT" 구성을 "트리" 또는 "테이블"로 설정하여 원하는 도구를 선택할 수 있습니다.

트리 모델

• metadata_query
  • 데이터베이스에서 메타데이터를 읽으려면 SHOW/COUNT 쿼리를 실행하세요.
  • 입력:
    • query_sql (문자열): 실행할 SHOW/COUNT SQL 쿼리
  • 반환: 객체 배열로 쿼리 결과
• select_query
  • 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.
  • 입력:
    • query_sql (문자열): 실행할 SELECT SQL 쿼리
  • 반환: 객체 배열로 쿼리 결과

테이블 모델

쿼리 도구

• read_query
  • 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.
  • 입력:
    • query (문자열): 실행할 SELECT SQL 쿼리
  • 반환: 객체 배열로 쿼리 결과

스키마 도구

• list_tables
  • 데이터베이스의 모든 테이블 목록을 가져옵니다.
  • 입력이 필요하지 않습니다
  • 반환: 테이블 이름 배열
• describe-table
  • 특정 테이블에 대한 스키마 정보 보기
  • 입력:
    • table_name (문자열): 설명할 테이블의 이름
  • 반환: 이름과 유형이 포함된 열 정의 배열

Claude 데스크톱 통합

필수 조건

• uv 패키지 관리자를 사용한 Python
• IoTDB 설치
• MCP 서버 종속성

개발

지엑스피1

Claude Desktop의 구성 파일에서 MCP 서버를 구성합니다.

맥OS

위치: ~/Library/Application Support/Claude/claude_desktop_config.json

윈도우

위치: %APPDATA%/Claude/claude_desktop_config.json

명령 필드에 uv 실행 파일의 전체 경로를 입력해야 할 수도 있습니다. MacOS/Linux에서는 which uv , Windows에서는 where uv 실행하여 경로를 확인할 수 있습니다.