Repolode
Enviar
ClickHouse

ClickHouse/mcp-clickhouse

Servidor MCP para que los asistentes de IA ejecuten consultas SQL y exploren esquemas de ClickHouse, con modo de solo lectura activado de forma predeterminada.

Ver en GitHub
Estrellas
890
Forks
210
Issues abiertos
8
Último commit
hace 23 horas

¿Qué es?

mcp-clickhouse es un servidor de Model Context Protocol (MCP) que conecta asistentes de IA como Claude Desktop a una base de datos ClickHouse. Expone herramientas para listar bases de datos, recorrer tablas por páginas y ejecutar consultas SQL, de modo que un asistente pueda explorar un esquema y responder preguntas analíticas sobre datos en tiempo real.

Las consultas se ejecutan en modo de solo lectura de forma predeterminada. Para habilitar las escrituras, hay que activar explícitamente CLICKHOUSE_ALLOW_WRITE_ACCESS; además, las instrucciones destructivas como DROP, TRUNCATE, DELETE y UPDATE requieren una segunda opción de activación. El proyecto también incluye un backend opcional de chDB para consultar archivos locales y fuentes de datos a través del motor integrado de ClickHouse, y admite los transportes stdio y HTTP/SSE con autenticación mediante bearer token u OAuth/OIDC.

El servidor está escrito en Python y se instala desde PyPI; normalmente se ejecuta mediante uv. También ofrece un endpoint /health para implementaciones HTTP.

Funciones clave

  • 01Ejecuta consultas SQL en un clúster de ClickHouse y devuelve resultados en JSON.
  • 02Lista bases de datos y recorre tablas por páginas con filtros LIKE.
  • 03Modo de solo lectura activado de forma predeterminada, con opciones independientes para habilitar escrituras y operaciones destructivas.
  • 04Admite consultas parametrizadas mediante marcadores de posición {name:Type} de ClickHouse.
  • 05Backend opcional de chDB para consultar archivos y fuentes de datos sin ETL.
  • 06Admite los transportes stdio, HTTP y SSE con autenticación mediante bearer token u OAuth/OIDC.

Casos de uso

  • Permitir que un asistente de IA explore esquemas de tablas y responda preguntas sobre datos de ClickHouse.
  • Ofrecer a los analistas una interfaz conversacional para consultar datos analíticos en modo de solo lectura.
  • Consultar archivos locales o fuentes remotas mediante el motor integrado chDB desde un asistente.

Inicio rápido

  1. 1

    Instala el paquete desde PyPI con el extra opcional chDB

    pip install 'mcp-clickhouse[chdb]'
  2. 2

    Configura la conexión con ClickHouse e inicia el servidor tal como se describe en el README

Antes de usarlo

  • Para que el inicio se complete correctamente, es necesario configurar la autenticación antes de usar los transportes HTTP y SSE.

Temas

#mcp#clickhouse#sql#ai-agent#database#llm-tools#python

Preguntas frecuentes

¿Qué es mcp-clickhouse?
Servidor MCP para que los asistentes de IA ejecuten consultas SQL y exploren esquemas de ClickHouse, con modo de solo lectura activado de forma predeterminada. mcp-clickhouse es un servidor de Model Context Protocol (MCP) que conecta asistentes de IA como Claude Desktop a una base de datos ClickHouse. Expone herramientas para listar bases de datos, recorrer tablas por páginas y ejecutar consultas SQL, de modo que un asistente pueda explorar un esquema y responder preguntas analíticas sobre datos en tiempo real.
¿mcp-clickhouse es gratuito? ¿Qué licencia tiene?
mcp-clickhouse es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-clickhouse sigue mantenido?
Mantenimiento activo. El último commit de mcp-clickhouse fue el 21 oct 2026.
¿Para qué puedo usar mcp-clickhouse?
Permitir que un asistente de IA explore esquemas de tablas y responda preguntas sobre datos de ClickHouse. Ofrecer a los analistas una interfaz conversacional para consultar datos analíticos en modo de solo lectura. Consultar archivos locales o fuentes remotas mediante el motor integrado chDB desde un asistente.
¿Cómo se instala mcp-clickhouse?
Instala el paquete desde PyPI con el extra opcional chDB: pip install 'mcp-clickhouse[chdb]' Configura la conexión con ClickHouse e inicia el servidor tal como se describe en el README
¿Dónde consigo mcp-clickhouse?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ClickHouse/mcp-clickhouse

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados