Skip to main content
Glama
enesjakozh

clickhouse-mcp-server

by burakdirin
GitHub
Python
MIT License
2
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor MCP de Clickhouse

Un proyecto de servidor MCP de base de datos de Clickhouse.

Instalación

Puedes instalar el paquete usando uv :

uv pip install clickhouse-mcp-server

O usando pip :

pip install clickhouse-mcp-server

Componentes

Herramientas

El servidor proporciona dos herramientas:

  • connect_database : se conecta a una base de datos específica de Clickhouse
    • parámetro database : Nombre de la base de datos a la que conectarse (cadena)
    • Devuelve un mensaje de confirmación cuando la conexión es exitosa
  • execute_query : ejecuta consultas de Clickhouse
    • parámetro query : consulta/consultas SQL a ejecutar (cadena)
    • Devuelve los resultados de la consulta en formato JSON
    • Se pueden enviar múltiples consultas separadas por punto y coma

Configuración

El servidor utiliza las siguientes variables de entorno:

  • CLICKHOUSE_HOST : Dirección del servidor de Clickhouse (predeterminado: "localhost")
  • CLICKHOUSE_USER : Nombre de usuario de Clickhouse (predeterminado: "root")
  • CLICKHOUSE_PASSWORD : Contraseña de Clickhouse (predeterminada: "")
  • CLICKHOUSE_DATABASE : Base de datos inicial (opcional)
  • CLICKHOUSE_READONLY : modo de solo lectura (establecido en 1/verdadero para habilitar, predeterminado: falso)

Inicio rápido

Instalación

Escritorio de Claude

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Ventanas: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "clickhouse-mcp-server": { "command": "uv", "args": [ "--directory", "/Users/burakdirin/Projects/clickhouse-mcp-server", "run", "clickhouse-mcp-server" ], "env": { "CLICKHOUSE_HOST": "localhost", "CLICKHOUSE_USER": "root", "CLICKHOUSE_PASSWORD": "password", "CLICKHOUSE_DATABASE": "[optional]", "CLICKHOUSE_READONLY": "true" } } } }
{ "mcpServers": { "clickhouse-mcp-server": { "command": "uvx", "args": [ "clickhouse-mcp-server" ], "env": { "CLICKHOUSE_HOST": "localhost", "CLICKHOUSE_USER": "root", "CLICKHOUSE_PASSWORD": "password", "CLICKHOUSE_DATABASE": "[optional]", "CLICKHOUSE_READONLY": "true" } } } }

Instalación mediante herrería

Para instalar automáticamente Clickhouse Database Integration Server para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @burakdirin/clickhouse-mcp-server --client claude

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar archivo de bloqueo:
uv sync
  1. Distribuciones de paquetes de compilación:
uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

  1. Publicar en PyPI:
uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/burakdirin/Projects/clickhouse-mcp-server run clickhouse-mcp-server

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Una implementación de servidor MCP que permite a Claude AI interactuar con las bases de datos de Clickhouse. Incluye conexiones seguras a bases de datos, ejecución de consultas, compatibilidad con modo de solo lectura y funciones de multiconsulta.

  1. Instalación
    1. Componentes
      1. Herramientas
    2. Configuración
      1. Inicio rápido
        1. Instalación
        2. Instalación mediante herrería
      2. Desarrollo
        1. Construcción y publicación
        2. Depuración

      Related Resources

      Related MCP Servers

      • Filesystem MCP Server

        ai-yliu
        A
        security
        F
        license
        A
        quality
        An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.
        Last updated -
        9
        2
        1
        JavaScript

      • ClickUp MCP Sedrver

        nsxdavid
        A
        security
        A
        license
        A
        quality
        ClickUp MCP Server enables AI assistants to seamlessly interact with your ClickUp workspace. This powerful integration allows Claude to create and manage tasks, access documents, organize folders and lists, add comments, and handle checklists—all through natural conversation.
        Last updated -
        42
        762
        22
        TypeScript
        MIT License
        • Apple

      • MCP Claude Code

        SDGLBL
        -
        security
        A
        license
        -
        quality
        An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
        Last updated -
        229
        Python
        MIT License
        • Apple
        • Linux

      • Claude AI Documentation Assistant

        XPE-7
        -
        security
        F
        license
        -
        quality
        An MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.
        Last updated -
        Python

      View all related MCP servers

      Appeared in Searches

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/burakdirin/clickhouse-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server