Uso de ClickHouse MCP server con Claude Desktop

Esta guía explica cómo configurar Claude Desktop con un ClickHouse MCP server usando uv y conectarlo a los conjuntos de datos de ejemplo de ClickHouse.

Instalar uv

Necesitarás instalar uv para seguir las instrucciones de esta guía. Si no quieres usar uv, tendrás que actualizar la configuración del MCP server para usar otro gestor de paquetes.

Descargar Claude Desktop

También tendrás que instalar la aplicación Claude Desktop, que puedes descargar desde el sitio web de Claude Desktop.

Configurar ClickHouse MCP server

Una vez que hayas instalado Claude Desktop, es hora de configurar el ClickHouse MCP server. Podemos hacerlo mediante el archivo de configuración de Claude Desktop.Para encontrar este archivo, primero ve a la página de configuración (Cmd+, en Mac) y luego haz clic en la pestaña Developer del menú de la izquierda. A continuación verás la siguiente pantalla, en la que tendrás que hacer clic en el botón Edit config:Esto te llevará a un directorio que contiene el archivo de configuración (claude_desktop_config.json). La primera vez que abras ese archivo, probablemente contendrá lo siguiente:

{
  "mcpServers": {}
}

El diccionario mcpServers toma como clave el nombre de un MCP server y como valor un diccionario de opciones de configuración. Por ejemplo, la configuración de ClickHouse MCP server para conectarse a ClickHouse Playground tendría este aspecto:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

Una vez que hayas actualizado la configuración, tendrás que reiniciar Claude Desktop para que los cambios surtan efecto.

Dependiendo de cómo hayas instalado uv, es posible que veas el siguiente error al reiniciar Claude Desktop:

MCP mcp-clickhouse: spawn uv ENOENT

Si eso ocurre, tendrás que actualizar command para que incluya la ruta completa a uv. Por ejemplo, si lo has instalado mediante Cargo, será /Users/<username>/.cargo/bin/uv