mcp-clickhousemcp-clickhouse MCP server

— (0)

리뷰어 Daniel Nikulshyn·업데이트됨 2026년 6월

개요

mcp-clickhouse MCP 서버는 ClickHouse의 MCP 서버입니다. ClickHouse 도구를 포함하고 있습니다. 이 도구에는 run_query를 통해 클라이언트의 ClickHouse 클러스터에서 SQL 쿼리를 실행할 수 있으며, list_databases를 통해 클라이언트의 ClickHouse 클러스터 내 모든 데이터베이스 목록을 출력할 수 있고, list_tables에서는 목록을 페이징하여 데이터베이스 내 모든 테이블을 조회할 수도 있습니다. 또한 chDB 툴을 포함하여 run_chdb_select_query로 chDB의 클릭하우스 엔진을 사용하여 SQL 쿼리를 실행할 수도 있습니다. 이는 또한 서버의 건강 여부를 확인할 수 있는 Health Check Endpoint 및 인증을 위한 보안 메커니즘이 있습니다. FastMCP를 사용해 OAuth/OIDC 인증 제공업체를 통해 OAuth/OIDC 인증을 통해 서버를 설정할 수도 있습니다.

주요 기능

ClickHouse 클러스터에서 SQL 쿼리 실행하기 위해 run_query 사용
ClickHouse 클러스터의 모든 데이터베이스 목록으로 list_databases 사용
데이터베이스 내 여러 페이지에 걸쳐서 table 목록으로 list_tables 사용
chDB의 내장 ClickHouse 엔진을 사용한 SQL 쿼리 실행하기 위해 run_chdb_select_query 사용
서버 모니터링을 위한 Healh Check Endpoint
OAuth 및 OIDC에 의해 FastMCP 통해 다중 인증 모드, Multi authentication modes

가격

모델: Free
카테고리: MCP 서버
평점: 아직 리뷰 없음

사용 사례

ClickHouse 서버 HEALTH 모니터링

Health Check Endpoint를 사용하여 서버의 HEALTH를 모니터링하고 문제를 감지합니다.

ClickHouse 클러스터에서 SQL 쿼리 실행

ClickHouse 도구 like run_query를 사용하여 ClickHouse 클러스터에서 SQL 쿼리를 실행합니다.

ClickHouse 서버를 위한 인증 처리

OAuth 및 OIDC를 포함한 여러 인증 모드를 지원하여 인증 및 권한을 구현합니다.

장단점

장점

ClickHouse 클러스터에서 SQL 쿼리 실행할 수 있습니다.
OAuth 및 OIDC를 포함한 다중 인증 모드 지원.
서버 모니터링을 위한 내장된 Healh Check Endpoint 지원

단점

보안 문제로 인해_ONLY 내부 서비스에만 적합합니다.
쿼리 실행의 유연성이 한정되어 있습니다.
적절한 인증 및 권한 구성 필요

대결 기록

Pantheon에서 1회 대결.

1위

2위

3위

Last battle

#3
MCP Servers Showdown — May 26, 2026
May 26, 2026 · #3 of 5

리뷰

리뷰를 작성하려면 로그인하세요.

아직 리뷰가 없습니다. 첫 번째가 되어보세요!

Q&A

mcp-clickhouse는 ClickHouse 클러스터에 쓰기 쿼리를 실행할 수 있나요?

기본적으로 쿼리는 읽기 전용 모드에서 실행됩니다 (`CLICKHOUSE_ALLOW_WRITE_ACCESS=false`). 필요하면 쓰기 접근을 명시적으로 활성화할 수 있으며, 이 경우 `run_query`를 사용해 INSERT 또는 UPDATE 문을 실행할 수 있습니다(서버가 쓰기를 허용하도록 구성된 경우).

Asked by Celia Ramirez · Aug 6, 2025

데이터베이스에서 테이블 목록을 조회할 때 사용할 수 있는 페이지네이션 옵션은 무엇인가요?

`list_tables` 도구는 `page_token`과 `page_size` 매개변수를 사용해 페이지네이션을 지원합니다. 기본적으로 페이지당 50개의 테이블이 반환되며, `page_size`를 조정하고 반환된 `next_page_token`을 사용해 이후 페이지를 가져올 수 있습니다. 또한 `like` 또는 `not_like`를 사용해 필터링할 수도 있습니다.

Asked by Marisol Pena · Jul 31, 2025

Kubernetes 환경에서 mcp-clickhouse 서버의 상태를 어떻게 모니터링할 수 있나요?

서버는 인증이 필요 없는 `/health` 엔드포인트를 노출합니다. ClickHouse에 연결할 수 있을 때는 `200 OK`와 본문 `OK`를 반환하고, 연결할 수 없으면 `503 Service Unavailable`를 반환합니다. 이 엔드포인트는 Kubernetes의 liveness/readiness 프로브나 로드 밸런서 체크용으로 설계되었습니다.

Asked by Kwame Mensah · Jul 8, 2025

mcp-clickhouse는 어떤 인증 방식을 지원하며, 어떻게 구성하나요?

mcp-clickhouse는 FastMCP를 통한 OAuth 및 OIDC, 내부 서비스 인증 등 다양한 인증 모드를 지원합니다. 설정은 서버의 JSON 구성 파일에서 FastMCP 설정을 통해 원하는 인증 제공자를 활성화하고 필요한 자격 증명을 지정하여 수행합니다.

Asked by Stella Papadopoulos · Jun 21, 2025