ClickHouse MCP
by ClickHouse
Consulta bases de datos ClickHouse con lenguaje natural para analytics en tiempo real y OLAP
database Python Intermedio Auto-hospedable Verificado
⭐ 200 stars 📅 Actualizado: hace 1m
Descripción
Servidor MCP oficial de ClickHouse que da a los LLMs acceso directo a bases de datos ClickHouse para analytics en tiempo real y consultas OLAP. Conecta tu asistente de IA a una de las bases de datos columnares más rápidas del mundo y explora miles de millones de filas mediante lenguaje natural. Soporta listar bases de datos y tablas, describir esquemas y ejecutar consultas SQL de solo lectura — todo a través de una interfaz segura y controlada. Ideal para exploración de datos, analytics ad-hoc y construir dashboards impulsados por IA que consulten ClickHouse en tiempo real.
✅ Ideal para
Equipos que usan ClickHouse para analytics y quieren exploración de datos asistida por IA
⏭️ No recomendado si
Necesitas acceso de escritura a la base de datos o usas un DBMS diferente
💡 Casos de uso
- Explorar grandes datasets analíticos mediante consultas conversacionales
- Ejecutar consultas OLAP ad-hoc en ClickHouse sin escribir SQL manualmente
- Construir dashboards impulsados por IA que extraigan métricas en tiempo real de ClickHouse
- Investigar problemas de calidad de datos inspeccionando esquemas y datos de muestra
👍 Ventajas
- ✓ Proyecto oficial mantenido por el equipo de ClickHouse
- ✓ Optimizado para el motor columnar de ClickHouse — consultas rápidas sobre miles de millones de filas
- ✓ Configuración simple vía pip install o uvx con variables de entorno
- ✓ Ejecución de consultas de solo lectura asegura exploración segura de datos
👎 Desventajas
- ✗ Requiere una instancia de ClickHouse en ejecución con acceso de red
- ✗ Limitado a operaciones de lectura — sin inserción de datos ni modificaciones de esquema
- ✗ Consultas analíticas complejas pueden producir resultados grandes que consumen contexto
🔧 Herramientas expuestas (4 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| list_databases | discovery | Listar todas las bases de datos disponibles en la instancia de ClickHouse |
| list_tables | discovery | Listar todas las tablas en una base de datos específica |
| describe_table | discovery | Obtener el esquema y detalles de columnas de una tabla |
| execute_query | query | Ejecutar una consulta SQL de solo lectura contra ClickHouse |
⚡ Instalación
Requisitos previos:
- • python v3.10+
- • ClickHouse instance credentials (host, user, password)
- • API key requerida
Consulta la documentación de Claude Code para configurar este MCP server.
💡 Consejos y trucos
Configura CLICKHOUSE_HOST, CLICKHOUSE_USER y CLICKHOUSE_PASSWORD como variables de entorno. Para ClickHouse Cloud, usa la cadena de conexión segura proporcionada en tu consola cloud. Empieza con list_databases y list_tables para orientar al LLM antes de ejecutar consultas.
🔄 Alternativas
Info rápida
- Autor
- ClickHouse
- Licencia
- Apache-2.0
- Runtime
- Python 3.10+
- Transporte
- stdio
- Categoría
- database
- Dificultad
- Intermedio
- Auto-hospedable
- ✅
- Auth
- —
- Docker
- —
- Versión
- latest
- Actualizado
- 28 feb 2026
Compatibilidad con clientes
- ✅ Claude Code
- ✅ Cursor
- ✅ VS Code Copilot
- ❓ Gemini CLI
- ✅ Windsurf
- ✅ Cline
- ❓ JetBrains AI
- ❓ Warp
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows