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.

Related MCP server: mcp-clickup

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>

3. Ejecute fastmcp install mcp_clickhouse/mcp_server.py -f .env.production para instalar el servidor.

4. 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

3. Ejecute uv sync para instalar las dependencias. Para instalar uv , siga las instrucciones aquí . Luego, ejecute source .venv/bin/activate .

4. Para realizar pruebas fácilmente, puede ejecutar fastmcp dev mcp_clickhouse/mcp_server.py para iniciar el servidor MCP.