Apache IoTDB MCP 서버

“IoTDB” MCP 서버는 무엇을 하나요?

Apache IoTDB MCP 서버는 모델 컨텍스트 프로토콜(Model Context Protocol, MCP)의 구현체로, 시계열 데이터베이스인 IoTDB를 통해 원활한 데이터베이스 상호작용 및 비즈니스 인텔리전스 기능을 제공합니다. 이 서버는 브릿지 역할을 하여, AI 어시스턴트와 클라이언트가 IoTDB에 대해 SQL 쿼리를 실행할 수 있게 하며, 자연어 또는 프로그래밍 방식의 LLM 기반 워크플로우에서 데이터 분석 및 관리 작업을 직접 지원합니다. 개발자는 MCP 서버를 활용해 데이터베이스 쿼리, 스키마 정보 확인, 메타데이터 조회 등의 작업을 수행할 수 있으며, 이를 통해 IoTDB를 AI 중심 개발 환경에 쉽게 통합하여 시계열 데이터 쿼리, 데이터베이스 스키마 관리 등 다양한 작업을 할 수 있습니다.

프롬프트 목록

이 서버는 프롬프트를 제공하지 않습니다.

리소스 목록

이 서버는 리소스를 제공하지 않습니다.

도구 목록

IoTDB MCP 서버는 선택한 SQL 다이얼렉트(“tree” 또는 “table”)에 따라 다양한 도구를 제공합니다.

트리 모델

• metadata_query
  • IoTDB 데이터베이스에서 메타데이터를 조회하기 위해 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 (문자열) – 설명할 테이블 이름
  • 출력: 컬럼 이름과 타입이 포함된 컬럼 정의 배열

이 MCP 서버의 활용 사례

• 시계열 데이터베이스 관리
  AI 어시스턴트 또는 LLM 기반 개발 도구에서 IoTDB에 저장된 대규모 시계열 데이터를 손쉽게 쿼리, 탐색, 관리할 수 있습니다.
• 스키마 탐색
  데이터베이스 스키마 조회, 테이블 목록 확인, 테이블 설명 등으로 데이터베이스 구조를 이해하고 문서화할 수 있습니다.
• 비즈니스 인텔리전스 통합
  자연어 쿼리와 스키마 분석을 통해 IoTDB 데이터를 BI 워크플로우에 통합하여 분석 및 리포팅을 지원합니다.
• 자동화된 데이터 분석
  MCP 서버를 자동화된 데이터 분석 파이프라인의 백엔드로 사용하여, LLM이 사용자 의도에 따라 SQL 쿼리를 생성하고 실행할 수 있습니다.
• 메타데이터 인스펙션
  SHOW/COUNT 쿼리로 데이터베이스 메타데이터를 조회하여 모니터링, 감사, 데이터베이스 최적화 작업에 활용할 수 있습니다.

설정 방법

Windsurf

1. Python이 설치되어 있고 uv 패키지 관리자가 준비되어 있는지 확인하세요.
2. IoTDB MCP 서버 저장소를 설치 또는 클론하세요.
3. Windsurf 설정 파일을 수정하여 IoTDB MCP 서버를 추가하세요.
4. 설정 파일에 아래 JSON 스니펫을 추가하세요:

   {
     "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"
         }
       }
     }
   }
   

5. 설정을 저장하고 Windsurf를 재시작하세요.
6. 서버가 정상적으로 동작하고 있는지 확인하세요.

Claude

1. 선행 조건으로 Python, uv, IoTDB를 설치하세요.
2. IoTDB MCP 서버 저장소를 클론하세요.
3. MacOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 파일을, Windows에서는 %APPDATA%/Claude/claude_desktop_config.json 파일을 수정하세요.
4. MCP 서버 항목을 추가하세요:

   {
     "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"
         }
       }
     }
   }
   

5. 변경사항을 저장하고 Claude Desktop을 재시작하세요.
6. Claude에서 서버가 정상적으로 연결되어 있는지 확인하세요.

Cursor

1. Python, uv, IoTDB가 설치되어 있는지 확인하세요.
2. MCP 서버 저장소를 클론하세요.
3. Cursor의 설정파일에 MCP 서버를 추가하세요.
4. 아래 JSON을 사용하세요:

   {
     "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"
         }
       }
     }
   }
   

5. 설정을 저장하고 Cursor를 재시작하세요.
6. MCP 서버가 활성화되어 응답하는지 확인하세요.

Cline

1. 필요한 의존성(Python, uv, IoTDB)을 설치하세요.
2. Apache IoTDB MCP 서버를 클론하세요.
3. Cline 설정 파일을 여세요.
4. MCP 서버 정보를 다음과 같이 추가하세요:

   {
     "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"
         }
       }
     }
   }
   

5. 저장하고 Cline을 재시작하세요.
6. MCP 서버 통합이 정상적으로 적용되었는지 확인하세요.

API 키 보안
IOTDB_USER, IOTDB_PASSWORD와 같은 API 자격 증명은 설정의 env 필드를 통해 관리됩니다. 중요한 데이터는 하드코딩하지 말고 환경 변수를 사용하세요. 예시:

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

서버를 시작하기 전에 해당 환경 변수를 시스템에 설정하시기 바랍니다.

플로우 내에서 MCP 사용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에서 다음 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "iotdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면 AI 에이전트가 MCP의 모든 기능과 도구에 접근할 수 있습니다. “iotdb"를 실제 사용 중인 MCP 서버 이름으로 변경하고, URL도 본인의 MCP 서버 주소로 바꿔주세요.

개요

전문가 의견

IoTDB MCP 서버는 IoTDB에 특화된 필수 데이터베이스 상호작용 도구만을 제공하는 간결한 구현체입니다. 프롬프트, 리소스, 루트, 샘플링 등 고급 MCP 기능은 없지만, 시계열 데이터베이스 접근이라는 특정 용도에는 적합합니다. Claude Desktop용 설치 방법이 잘 문서화되어 있고, 다른 통합도 표준적입니다. 전반적으로 데이터베이스 중심 워크플로우에 적합한 틈새지만 탄탄한 MCP 서버입니다.

MCP 점수