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.

Servidor MCP de ClickHouse

Migrado a https://github.com/ClickHouse/mcp-clickhouse

Un servidor MCP para ClickHouse.

Características

Herramientas

  • run_select_query
    • Ejecute consultas SQL en su clúster ClickHouse.
    • Entrada: sql (cadena): la consulta SQL a ejecutar.
    • Todas las consultas de ClickHouse se ejecutan con readonly = 1 para garantizar que sean seguras.
  • list_databases
    • Enumere todas las bases de datos en su clúster ClickHouse.
  • list_tables
    • Enumerar todas las tablas de una base de datos.
    • Entrada: database (cadena): el nombre de la base de datos.

Configuración

Nota : Este es un proceso de configuración temporal que se mejorará significativamente una vez que se publique el paquete.

  1. Ejecute uv sync para instalar las dependencias. Para instalar uv , siga las instrucciones aquí . Luego, ejecute source .venv/bin/activate .
  2. Configure el archivo .env.production con las credenciales de ClickHouse.
CLICKHOUSE_HOST=<CLICKHOUSE_HOST> CLICKHOUSE_PORT=<CLICKHOUSE_PORT> CLICKHOUSE_USER=<CLICKHOUSE_USER> CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>
  1. Ejecute fastmcp install mcp_clickhouse/mcp_server.py -f .env.production para instalar el servidor.
  2. Reinicie Claude Desktop.

Desarrollo

  1. En el directorio de test-services ejecute docker compose up -d para iniciar el clúster ClickHouse.
  2. Agregue las siguientes variables a un archivo .env en la raíz del repositorio.
CLICKHOUSE_HOST=localhost CLICKHOUSE_PORT=8123 CLICKHOUSE_USER=default CLICKHOUSE_PASSWORD=clickhouse
  1. Ejecute uv sync para instalar las dependencias. Para instalar uv , siga las instrucciones aquí . Luego, ejecute source .venv/bin/activate .
  2. Para realizar pruebas fácilmente, puede ejecutar fastmcp dev mcp_clickhouse/mcp_server.py para iniciar el servidor MCP.

You must be authenticated.

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

Un servidor MCP para ClickHouse.

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