ClickHouse MCP Server의 개요
ClickHouse MCP Server는 ClickHouse 클러스터에 SQL을 실행하기 위한 ClickHouse의 오픈소스 서버입니다. 주요 도구는 3개입니다. SQL용 run_query, list_databases, 그리고 스키마 정보를 페이지 단위로 주는 list_tables입니다. run_query는 DESCRIBE와 EXPLAIN ESTIMATE도 처리하므로, 에이전트는 쿼리를 실행하기 전에 출력과 예상 읽기량을 확인할 수 있습니다. 버전 0.7.0(2026년 9월 21일)부터는 이름 있는 쿼리 파라미터도 받습니다. 선택 사항인 chDB 도구는 ClickHouse의 내장 엔진으로 파일과 URL에 SQL을 실행합니다.
PyPI에서 설치하고(uvx mcp-clickhouse) CLICKHOUSE_HOST 같은 연결 정보를 환경 변수로 설정합니다. 기본은 stdio이며 HTTP나 SSE로도 실행할 수 있는데, 이때는 bearer 토큰, OAuth나 OIDC 제공자, 또는 명시적인 해제 설정이 없으면 시작을 거부합니다.
ClickHouse Cloud 고객에게는 두 번째 선택지가 있습니다. https://mcp.clickhouse.cloud/mcp의 관리형 원격 서버로, 읽기 전용 도구 13개와 OAuth 또는 API 키 로그인을 제공하며 Cloud 콘솔에서 서비스별로 켭니다. 오픈소스 저장소는 GitHub 스타가 약 890개이고 Apache 2.0 라이선스입니다.
ClickHouse MCP Server 설치 방법
uvx mcp-clickhouseClickHouse MCP Server, 쓸 만한 가치가 있습니까?
분석 작업에서는 작은 도구 세트가 강점입니다. 에이전트는 데이터베이스와 테이블을 나열하고, EXPLAIN ESTIMATE로 쿼리가 몇 개의 행과 파트를 읽을지 확인한 뒤 실행합니다. 읽기 전용 모드가 기본이며, SQL을 파싱하는 방식이 아니라 ClickHouse 자체에서 readonly=1로 강제됩니다. 쓰기를 켜려면 CLICKHOUSE_ALLOW_WRITE_ACCESS가 필요하고, DROP, TRUNCATE, DELETE, UPDATE에는 그 위에 두 번째 플래그인 CLICKHOUSE_ALLOW_DROP이 필요합니다.
보안 설명은 보기 드물게 꼼꼼합니다. HTTP 모드는 인증 없이는 시작하지 않습니다. README는 설치된 패키지보다 상위 경로 어디에 있는 .env 파일이든 인증 설정을 바꿀 수 있고, 읽기 전용 사용자도 같은 사용자로 실행 중인 다른 쿼리를 취소할 수 있으며, 값이 쿼리 로그에 남을 수 있으므로 파라미터 바인딩은 개인정보 보호 기능이 아니라고 경고합니다. 파괴적 작업 검사는 실수를 막는 장치일 뿐이고 실제 경계는 ClickHouse 권한이라고 분명히 말합니다.
빈틈은 결과 크기입니다. 쿼리는 기본으로 30초 후에 타임아웃되지만, 열린 issue에 따르면 300만 행의 SELECT가 그 시간 안에 231 MiB의 페이로드를 돌려주었고, 이는 어떤 모델의 컨텍스트든 넘치게 하기에 충분합니다. 제안된 상한이 반영될 때까지는 LIMIT을 붙이는 습관, 데이터베이스 사용자의 max_result_rows 설정, 또는 미들웨어가 해결책입니다.
ClickHouse에 호스팅 방식이 없다는 예전의 주장은 이제 맞지 않습니다. ClickHouse Cloud의 관리형 엔드포인트는 서비스, 백업, ClickPipes, 그리고 31일 범위의 조직 비용 조회를 위한 읽기 전용 도구를 더하며, 설치할 것이 없습니다. 오픈소스 서버는 여전히 자체 관리 클러스터, chDB, 또는 자체 통제 아래에서 쓰기 권한을 원하는 팀을 위한 것입니다.
제 역할을 하는 곳
ClickHouse Cloud를 쓰는 직원 50명 규모 전자상거래 회사의 제품 분석가
SQL을 쓰지 않고 주문과 퍼널에 관한 즉석 질문에 답하기
전용 ClickHouse 사용자로 Claude를 읽기 전용 서버에 연결하고, 에이전트가 테이블을 나열하고 SELECT마다 먼저 EXPLAIN ESTIMATE를 실행하게 합니다. 서버는 무료이고, 쿼리는 Cloud 서비스의 컴퓨팅으로 과금되며 AWS us-east-1 Enterprise에서 단위 시간당 약 $0.39부터입니다.
Kubernetes에서 자체 관리 ClickHouse를 운영하는 데이터 플랫폼 엔지니어
여러 사내 에이전트에게 웨어하우스에 대한 공유된 인증 접근을 주기
FastMCP를 통해 OIDC 제공자와 함께 HTTP로 mcp-clickhouse를 실행하고, 쓰기를 끈 채로 테넌트별 설정을 지정하는 미들웨어를 추가합니다. 테넌트 격리는 여전히 ClickHouse 사용자와 역할로 해야 합니다.
노트북에서 Parquet 파일을 다루는 데이터 과학자
데이터베이스에 적재하지 않고 로컬과 원격 파일을 SQL로 조회하기
mcp-clickhouse[chdb]를 설치하고 run_chdb_select_query를 켭니다. 내장 엔진이 파일과 URL을 직접 읽습니다. 서버도 Cloud 청구서도 없지만, chDB 쿼리에는 엔진이 허용하는 범위 외에 MCP 쪽 쓰기 보호가 없습니다.
도입 전 확인할 점
- 설정
- 클라이언트 설정에 CLICKHOUSE_HOST, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD와 함께 uvx mcp-clickhouse를 넣습니다. Claude Desktop과 다른 stdio 클라이언트용으로 문서화되어 있습니다. ClickHouse Cloud 사용자는 대신 서비스에서 MCP를 켜고 클라이언트를 https://mcp.clickhouse.cloud/mcp로 지정할 수 있습니다.
- 연동
- 도구 3개(run_query, list_databases, list_tables)와 선택 사항인 run_chdb_select_query가 있습니다. run_query는 쓰기를 켜지 않으면 읽기 전용입니다. FastMCP 미들웨어로 로깅이나 사용자별 설정을 위해 호출을 가로챌 수 있습니다.
- 데이터와 개인정보
- 서버는 ClickHouse 사용자에게 주어진 권한 안의 모든 것을 읽을 수 있으므로, 최소 권한의 전용 사용자를 쓰십시오. 서버는 사용자의 컴퓨터에서 돌며, 데이터베이스가 ClickHouse Cloud에 있지 않다면 회사인 ClickHouse로는 아무것도 가지 않습니다. 쿼리 파라미터는 ClickHouse 쿼리 로그에 남을 수 있습니다.
- 대규모 사용 시 비용
- 서버는 무료입니다. ClickHouse Cloud Enterprise에서 컴퓨팅은 리전에 따라 단위 시간당(8 GiB, 2 vCPU) $0.33에서 $0.52, 스토리지는 TB-월당 $22에서 $27.50입니다. EXPLAIN ESTIMATE 없이 스캔하는 에이전트는 유휴 서비스를 깨워 컴퓨팅을 소모할 수 있습니다.
- 제한
- 기본 쿼리 타임아웃은 30초이고 워커 스레드는 10개입니다. 반환 행 수에 상한이 없고(issue #223), 관리 도구가 없으며, 내장 다중 사용자 모드도 없습니다. 호스팅 Cloud 서버의 청구 도구는 쿼리당 최대 31일을 다룹니다.
좋은 점
- 기본이 읽기 전용이며, 서버 쪽에서 readonly=1로 강제됩니다
- DROP, TRUNCATE, DELETE, UPDATE는 별도로 허용해야 합니다
- EXPLAIN ESTIMATE로 에이전트가 실행 전에 비용을 확인합니다
- HTTP 모드에는 토큰이나 OAuth/OIDC가 필요합니다
아쉬운 점
- 결과 크기에 상한이 없어 큰 SELECT가 컨텍스트를 넘치게 할 수 있습니다
- 직접 실행하는 서버에는 Python과 uv가 필요합니다
- ClickHouse 권한 외에는 다중 사용자나 테넌트 격리가 없습니다
- Cloud의 호스팅 서버는 별도의 읽기 전용 제품입니다
추천 대상
안전한 기본값으로 ClickHouse에서 에이전트가 질문에 답하게 하고 싶은 데이터 팀입니다.
ClickHouse MCP Server 대안
ClickHouse MCP Server: 자주 묻는 질문
- ClickHouse MCP Server, 쓸 만한 가치가 있습니까?
- 도구 3개와 읽기 전용 기본값 덕분에 분석 에이전트의 첫 데이터베이스 서버로 안전합니다. 다만 결과 크기의 상한은 직접 정해야 합니다. 평점은 5점 만점에 4.2점입니다.
- ClickHouse MCP Server의 가격은 얼마입니까?
- 무료이며 Apache-2.0 라이선스입니다. ClickHouse Cloud는 별도로 과금되며(Enterprise 컴퓨팅은 8 GiB 단위 시간당 약 $0.33부터), $300 크레딧이 있는 30일 체험판을 제공합니다.
- ClickHouse MCP Server의 단점은 무엇입니까?
- 결과 크기에 상한이 없어 큰 SELECT가 컨텍스트를 넘치게 할 수 있습니다; 직접 실행하는 서버에는 Python과 uv가 필요합니다; ClickHouse 권한 외에는 다중 사용자나 테넌트 격리가 없습니다; Cloud의 호스팅 서버는 별도의 읽기 전용 제품입니다.
- ClickHouse MCP Server에 적합한 사람은 누구입니까?
- 안전한 기본값으로 ClickHouse에서 에이전트가 질문에 답하게 하고 싶은 데이터 팀입니다.
- 팀이나 프로덕션 환경에서 ClickHouse MCP Server의 비용은 얼마입니까?
- 서버는 무료입니다. ClickHouse Cloud Enterprise에서 컴퓨팅은 리전에 따라 단위 시간당(8 GiB, 2 vCPU) $0.33에서 $0.52, 스토리지는 TB-월당 $22에서 $27.50입니다. EXPLAIN ESTIMATE 없이 스캔하는 에이전트는 유휴 서비스를 깨워 컴퓨팅을 소모할 수 있습니다.
- ClickHouse MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 서버는 ClickHouse 사용자에게 주어진 권한 안의 모든 것을 읽을 수 있으므로, 최소 권한의 전용 사용자를 쓰십시오. 서버는 사용자의 컴퓨터에서 돌며, 데이터베이스가 ClickHouse Cloud에 있지 않다면 회사인 ClickHouse로는 아무것도 가지 않습니다. 쿼리 파라미터는 ClickHouse 쿼리 로그에 남을 수 있습니다.
- ClickHouse MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Snowflake-managed MCP Server, MCP Toolbox for Databases 및 Grafana MCP Server입니다.
답변 확인일: 2026년 10월 23일.
ClickHouse MCP Server 개발사입니까? 이 평점을 사이트에 표시하십시오
