본문 바로가기
M MCP모아

데이터 · ClickHouse 공식

ClickHouse MCP

ClickHouse가 공개한 MCP 서버로, ClickHouse 클러스터와 chDB에 SQL을 실행하고 데이터베이스와 테이블 구조를 탐색합니다. 쿼리는 기본이 읽기 전용이며 쓰기는 CLICKHOUSE_ALLOW_WRITE_ACCESS로 명시적으로 켜야 합니다. 쿼리 파라미터 바인딩과 테이블 목록 페이지 나누기를 지원합니다. 접속 정보는 환경변수로 전달하며 TLS와 인증서 옵션도 지원합니다. 레지스트리에는 PyPI와 OCI 이미지 두 형태가 올라 있습니다.

연결 방법

Claude Code

claude mcp add clickhouse -e CLICKHOUSE_HOST=호스트 -e CLICKHOUSE_USER=사용자 -e CLICKHOUSE_PASSWORD=비밀번호 -- uvx mcp-clickhouse

로컬 실행 명령

uvx mcp-clickhouse

Claude Desktop — claude_desktop_config.json의 mcpServers에 uvx mcp-clickhouse 실행 설정과 CLICKHOUSE_HOST 등 접속 환경변수를 추가합니다.

할 수 있는 일

  • SQL 실행(run_query)
  • 데이터베이스 목록
  • 테이블 목록·구조 조회
  • 파라미터 바인딩 쿼리

이렇게 물어보세요

스키마 파악

“analytics 데이터베이스의 테이블 목록과 컬럼 구조를 정리해 줘.”

집계 쿼리

“지난 7일 일별 이벤트 수를 집계하는 쿼리를 실행해 줘.”

쿼리 점검

“이 쿼리의 예상 읽기량을 확인해 줘.”

데이터 흐름과 주의할 점

로컬에서 실행되어 지정한 ClickHouse 서버에 직접 접속합니다. 쿼리 결과는 AI 클라이언트로 전달됩니다.

  • 기본은 읽기 전용이지만 환경변수로 쓰기와 삭제(DROP) 허용을 켤 수 있으니 켜지 않는 것을 권장합니다.
  • 접속 계정에는 필요한 테이블만 읽을 수 있는 권한을 주세요.
  • 레지스트리에는 io.github.ClickHouse/loom 항목도 있으나 이번에 확인하지 않았습니다.