IoTDB MCP 서버

👁 대장간 배지

개요

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

Related MCP server: Microsoft SQL Server MCP Server

구성 요소

자원

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

프롬프트

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

도구

이 서버는 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 실행하여 경로를 확인할 수 있습니다.

{
 "mcpServers": {
 "iotdb": {
 "command": "uv",
 "args": [
 "--directory",
 "YOUR_REPO_PATH/src/iotdb_mcp_server",
 "run",
 "server.py"
 ],
 "env": {
 "IOTDB_HOST": "127.0.0.1",
 "IOTDB_PORT": "6667",
 "IOTDB_USER": "root",
 "IOTDB_PASSWORD": "root",
 "IOTDB_DATABASE": "test",
 "IOTDB_SQL_DIALECT": "table"
 }
 }
 }
}

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• describe_tableC
• export_table_queryA
• list_tablesB
• read_queryB