mcp-clickhouse

mcp-clickhouse

PythonCloudSqlDatabaseJavascriptGoRubyR

About This Server

An MCP server for ClickHouse.

Server Information

šŸ“‹ Overview:

This webpage is the GitHub repository page for "mcp-clickhouse," a project by ClickHouse. The project aims to provide an MCP (Machine Communication Protocol) server for ClickHouse, a fast open-source OLAP database management system. The page offers information about the repository including code, issues, pull requests, actions, security insights, and contributors. It provides details on the project's features, configuration, development, and environment variables.


ā­ Key Points:
  • The repository hosts the code for an MCP server designed for ClickHouse.

  • It lists available tools within the server, including `runselectquery`, `listdatabases`, and `listtables`.

  • Configuration instructions are provided for connecting the MCP server to a ClickHouse instance, including specific settings for the ClickHouse SQL Playground.

  • The development section gives instructions on setting up a local development environment using Docker.

  • The page provides links to other related information such as issues, pull requests, code of conduct, and activity.

  • It uses the Apache-2.0 license.


  • šŸ” Main Findings:
  • The "mcp-clickhouse" project facilitates interaction with ClickHouse database using the MCP protocol.

  • The project provides several pre-built tools or methods.

  • Users can run SQL queries, list databases, and list tables.

  • The project emphasizes secure configuration with HTTPS and SSL verification.

  • The "uv" package manager is utilized.


  • šŸ“Š Details:
  • The project is public and has been forked 15 times and starred 83 times.

  • The primary programming language used is Python (100%).

  • Instructions are available to configure the MCP server for local development, ClickHouse Cloud, and ClickHouse SQL Playground.

  • The repository contains files related to workflows, ClickHouse management, testing, editor configuration, license, readme, project configuration, and dependency locking.


šŸŽÆ Conclusion:
The "mcp-clickhouse" repository offers an MCP server solution for ClickHouse, complete with instructions for configuration, usage, and development. It provides tools for database interaction and emphasizes secure connection practices. It's intended for use with the Claude Desktop configuration.

Server Features

run_select_query

Execute SQL queries on your ClickHouse cluster. All ClickHouse queries are run with readonly = 1 to ensure they are safe.

list_databases

List all databases on your ClickHouse cluster.

list_tables

List all tables in a database.

Provider Information

Clickhouse logo

Clickhouse

cloud Provider

Visit Provider Website

Quick Actions

Visit Website

MCP Configuration

Available Tools

run_select_querylist_databaseslist_tables