← Back to Plugins
MCP Server MCP

ClickHouse

github By github 👁 1 views ▲ 0 votes

Official ClickHouse MCP server for querying and exploring ClickHouse clusters and chDB.

Homepage Verified source GitHub

Install

uvx mcp-clickhouse

Configuration Example

{
  "remotes": [],
  "packages": [
    {
      "registryType": "pypi",
      "identifier": "mcp-clickhouse",
      "version": "0.4.1",
      "runtimeHint": "uvx",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Hostname of the ClickHouse server",
          "isRequired": true,
          "name": "CLICKHOUSE_HOST"
        },
        {
          "description": "Username for ClickHouse authentication",
          "isRequired": true,
          "name": "CLICKHOUSE_USER"
        },
        {
          "description": "Password for ClickHouse authentication",
          "isRequired": true,
          "isSecret": true,
          "name": "CLICKHOUSE_PASSWORD"
        },
        {
          "description": "ClickHouse HTTP(S) port. Defaults to 8443 when CLICKHOUSE_SECURE=true, 8123 otherwise",
          "name": "CLICKHOUSE_PORT"
        },
        {
          "description": "Use HTTPS to connect to ClickHouse",
          "format": "boolean",
          "default": "true",
          "name": "CLICKHOUSE_SECURE"
        },
        {
          "description": "Verify SSL certificates",
          "format": "boolean",
          "default": "true",
          "name": "CLICKHOUSE_VERIFY"
        },
        {
          "description": "Default database to use",
          "name": "CLICKHOUSE_DATABASE"
        },
        {
          "description": "ClickHouse role to activate for the session",
          "name": "CLICKHOUSE_ROLE"
        },
        {
          "description": "Allow write operations (DDL and DML). Queries run read-only by default",
          "format": "boolean",
          "default": "false",
          "name": "CLICKHOUSE_ALLOW_WRITE_ACCESS"
        },
        {
          "description": "Allow destructive operations (DROP, TRUNCATE) when write access is also enabled",
          "format": "boolean",
          "default": "false",
          "name": "CLICKHOUSE_ALLOW_DROP"
        },
        {
          "description": "Query tool timeout in seconds",
          "format": "number",
          "default": "30",
          "name": "CLICKHOUSE_MCP_QUERY_TIMEOUT"
        }
      ]
    },
    {
      "registryType": "oci",
      "identifier": "ghcr.io/clickhouse/mcp-clickhouse:0.4.1",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Hostname of the ClickHouse server",
          "isRequired": true,
          "name": "CLICKHOUSE_HOST"
        },
        {
          "description": "Username for ClickHouse authentication",
          "isRequired": true,
          "name": "CLICKHOUSE_USER"
        },
        {
          "description": "Password for ClickHouse authentication",
          "isRequired": true,
          "isSecret": true,
          "name": "CLICKHOUSE_PASSWORD"
        },
        {
          "description": "ClickHouse HTTP(S) port. Defaults to 8443 when CLICKHOUSE_SECURE=true, 8123 otherwise",
          "name": "CLICKHOUSE_PORT"
        },
        {
          "description": "Use HTTPS to connect to ClickHouse",
          "format": "boolean",
          "default": "true",
          "name": "CLICKHOUSE_SECURE"
        },
        {
          "description": "Verify SSL certificates",
          "format": "boolean",
          "default": "true",
          "name": "CLICKHOUSE_VERIFY"
        },
        {
          "description": "Default database to use",
          "name": "CLICKHOUSE_DATABASE"
        },
        {
          "description": "ClickHouse role to activate for the session",
          "name": "CLICKHOUSE_ROLE"
        },
        {
          "description": "Allow write operations (DDL and DML). Queries run read-only by default",
          "format": "boolean",
          "default": "false",
          "name": "CLICKHOUSE_ALLOW_WRITE_ACCESS"
        },
        {
          "description": "Allow destructive operations (DROP, TRUNCATE) when write access is also enabled",
          "format": "boolean",
          "default": "false",
          "name": "CLICKHOUSE_ALLOW_DROP"
        },
        {
          "description": "Query tool timeout in seconds",
          "format": "number",
          "default": "30",
          "name": "CLICKHOUSE_MCP_QUERY_TIMEOUT"
        }
      ]
    }
  ]
}
mcp model-context-protocol pypi oci

Comments

Sign in to leave a comment

Loading comments...