MCP ExplorerExplorer

Mcp Server Clickhouse

@alexkorepon a year ago
1 MIT
FreeCommunity
AI Systems
MCP server for ClickHouse Cloud API management and interaction.

Overview

What is Mcp Server Clickhouse

mcp-server-clickhouse is a server that provides tools to interact with the ClickHouse Cloud API (v1), enabling management of organizations and services within ClickHouse Cloud.

Use cases

Use cases include managing data analytics workflows, integrating ClickHouse Cloud with other applications, and automating data operations within organizations.

How to use

To use mcp-server-clickhouse, clone the repository, install dependencies using ‘npm install’, build the TypeScript code with ‘npm run build’, and configure the environment variables for your ClickHouse API key before running the server.

Key features

Key features include exposing the ClickHouse Cloud API endpoint via MCP tools, authenticating using ClickHouse OpenAPI Key ID and Secret, and handling JSON request bodies and responses.

Where to use

mcp-server-clickhouse can be used in cloud-based data analytics, business intelligence applications, and any environment requiring interaction with ClickHouse Cloud services.

Content

ClickHouse Cloud MCP Server

This MCP server provides tools to interact with the ClickHouse Cloud API (v1). It allows managing organizations and services, the rest is TODO.

Features

  • Exposes ClickHouse Cloud API endpoint via MCP tools.
  • Authenticates using ClickHouse OpenAPI Key ID and Secret provided via environment variables.
  • Handles JSON request bodies and responses.

Prerequisites

You need a ClickHouse Cloud API Key.

Installation

Clone this repository and install the dependencies:

npm install

Build the TypeScript code:

npm run build

This will create a dist directory containing the compiled JavaScript file.

Configuration

This server requires the following environment variables to be set:

  • CLICKHOUSE_API_KEY_ID: Your ClickHouse Cloud API Key ID.
  • CLICKHOUSE_API_SECRET: Your ClickHouse Cloud API Key Secret.
  • CLICKHOUSE_API_URL: The base URL for the ClickHouse Cloud API (default is https://api.clickhouse.cloud).
    Use http://localhost:2023 for local development.

Usage with Claude Desktop

Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "clickhouse": {
      "command": "node",
      "args": [
        "/full/path/to/dist/index.js"
      ],
      "env": {
        "CLICKHOUSE_API_KEY_ID": "key id",
        "CLICKHOUSE_API_SECRET": "key secret",
        "CLICKHOUSE_API_URL": "http://localhost:2023"
      }
    }
  }
}

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers