ClickHouse MCP Server

ClickHouse MCP 서버

https://github.com/ClickHouse/mcp-clickhouse 로 마이그레이션되었습니다.

ClickHouse용 MCP 서버.

특징

도구

• run_select_query
  • ClickHouse 클러스터에서 SQL 쿼리를 실행합니다.
  • 입력: sql (문자열): 실행할 SQL 쿼리.
  • 모든 ClickHouse 쿼리는 안전을 보장하기 위해 readonly = 1 로 실행됩니다.
• list_databases
  • ClickHouse 클러스터에 있는 모든 데이터베이스를 나열합니다.
• list_tables
  • 데이터베이스의 모든 테이블을 나열합니다.
  • 입력: database (문자열): 데이터베이스의 이름입니다.

구성

참고 : 이는 패키지가 게시되면 상당히 개선될 임시 구성 프로세스입니다.

1. uv sync 실행하여 종속성을 설치하세요. uv 설치하려면 여기의 지침을 따르세요. 그런 다음 source .venv/bin/activate 실행하세요.
2. ClickHouse 자격 증명으로 .env.production 파일을 설정합니다.

지엑스피1

3. fastmcp install mcp_clickhouse/mcp_server.py -f .env.production 실행하여 서버를 설치합니다.
4. Claude Desktop을 다시 시작합니다.

개발

1. test-services 디렉토리에서 docker compose up -d 실행하여 ClickHouse 클러스터를 시작합니다.
2. 저장소 루트에 있는 .env 파일에 다음 변수를 추가합니다.

3. uv sync 실행하여 종속성을 설치하세요. uv 설치하려면 여기의 지침을 따르세요. 그런 다음 source .venv/bin/activate 실행하세요.
4. 간편하게 테스트하려면 fastmcp dev mcp_clickhouse/mcp_server.py 실행하여 MCP 서버를 시작할 수 있습니다.