ClickHouse MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows querying and interacting with ClickHouse databases, providing tools for executing SQL select queries, listing databases, and viewing tables within a database.

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

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

개발

  1. test-services 디렉토리에서 docker compose up -d 실행하여 ClickHouse 클러스터를 시작합니다.
  2. 저장소 루트에 있는 .env 파일에 다음 변수를 추가합니다.
CLICKHOUSE_HOST=localhost CLICKHOUSE_PORT=8123 CLICKHOUSE_USER=default CLICKHOUSE_PASSWORD=clickhouse
  1. uv sync 실행하여 종속성을 설치하세요. uv 설치하려면 여기의 지침을 따르세요. 그런 다음 source .venv/bin/activate 실행하세요.
  2. 간편하게 테스트하려면 fastmcp dev mcp_clickhouse/mcp_server.py 실행하여 MCP 서버를 시작할 수 있습니다.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

ClickHouse용 MCP 서버.

  1. Migrated to https://github.com/ClickHouse/mcp-clickhouse
    1. Features
    2. Configuration
    3. Development
ID: 9292900sx1