ClickHouse/mcp-clickhouse

어떤 프로젝트인가요?

핵심 기능

• 01ClickHouse 클러스터에서 SQL 쿼리를 실행하고 JSON 결과를 받습니다.
• 02LIKE 필터를 사용해 데이터베이스를 조회하고 테이블을 페이지 단위로 살펴봅니다.
• 03기본적으로 읽기 전용이며, 쓰기 작업과 파괴적 작업에는 각각 별도의 허용 플래그가 필요합니다.
• 04ClickHouse의 {name:Type} 플레이스홀더를 사용한 매개변수화 쿼리를 지원합니다.
• 05ETL 없이 파일과 데이터 소스를 쿼리할 수 있는 선택형 chDB 백엔드를 제공합니다.
• 06bearer-token 또는 OAuth/OIDC 인증을 사용하는 stdio, HTTP, SSE 전송 방식을 지원합니다.

활용 사례

• AI assistant가 테이블 스키마를 살펴보고 ClickHouse 데이터에 관한 질문에 답하도록 합니다.
• 분석가에게 읽기 전용 분석 데이터를 다룰 수 있는 대화형 인터페이스를 제공합니다.
• assistant에서 내장 chDB 엔진을 통해 로컬 파일이나 원격 데이터 소스를 쿼리합니다.

빠른 시작

1. 1

   선택적 chDB extra를 포함해 PyPI에서 패키지를 설치합니다

   pip install 'mcp-clickhouse[chdb]'
2. 2

   README에 설명된 대로 ClickHouse 연결을 구성하고 서버를 시작합니다

사용 전 알아둘 점

• !HTTP 및 SSE 전송을 사용하려면 시작이 성공하기 전에 인증을 구성해야 합니다.

토픽

자주 묻는 질문

mcp-clickhouse은(는) 무엇인가요?

AI assistant가 ClickHouse에서 SQL 쿼리를 실행하고 스키마를 살펴볼 수 있게 해주는 MCP 서버로, 기본적으로 읽기 전용 모드로 동작합니다. mcp-clickhouse는 Claude Desktop 같은 AI assistant를 ClickHouse 데이터베이스에 연결하는 Model Context Protocol (MCP) 서버입니다. 데이터베이스 목록 조회, 테이블 페이지 탐색, SQL 쿼리 실행 도구를 제공하므로 assistant가 스키마를 살펴보고 실시간 데이터를 바탕으로 분석 질문에 답할 수 있습니다.

mcp-clickhouse은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mcp-clickhouse은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mcp-clickhouse은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mcp-clickhouse의 마지막 커밋은 2026년 10월 21일입니다.

mcp-clickhouse은(는) 어디에 사용할 수 있나요?

AI assistant가 테이블 스키마를 살펴보고 ClickHouse 데이터에 관한 질문에 답하도록 합니다. 분석가에게 읽기 전용 분석 데이터를 다룰 수 있는 대화형 인터페이스를 제공합니다. assistant에서 내장 chDB 엔진을 통해 로컬 파일이나 원격 데이터 소스를 쿼리합니다.

mcp-clickhouse는 어떻게 설치하나요?

선택적 chDB extra를 포함해 PyPI에서 패키지를 설치합니다: pip install 'mcp-clickhouse[chdb]' README에 설명된 대로 ClickHouse 연결을 구성하고 서버를 시작합니다

mcp-clickhouse은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ClickHouse/mcp-clickhouse