ClickHouse MCP Server

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.

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.

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.