Skip to content

Commit 0058ce4

Browse files
committed
Add ClickHouse MCP server
Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com> Claude-Session: https://claude.ai/code/session_01S58U7phvDgphx6ZTXuWMJQ
1 parent 14015a9 commit 0058ce4

1 file changed

Lines changed: 123 additions & 0 deletions

File tree

Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.clickhouse-mcp-uvx",
4+
"name": "ClickHouse (uvx)",
5+
"alias": "clickhouse",
6+
"description": "Query ClickHouse databases and chDB. List databases and tables, inspect schemas, and run SELECT queries (read-only by default) against ClickHouse Cloud or self-hosted clusters.",
7+
"logo": "https://avatars.githubusercontent.com/u/54801242?v=4",
8+
"schema_version": "2.1",
9+
"categories": [
10+
"database"
11+
],
12+
"tags": [
13+
"clickhouse",
14+
"database",
15+
"analytics",
16+
"olap",
17+
"sql",
18+
"data-warehouse"
19+
],
20+
"transport": {
21+
"type": "stdio",
22+
"command": "uvx",
23+
"args": [
24+
"mcp-clickhouse"
25+
],
26+
"env": {
27+
"CLICKHOUSE_HOST": "${input:CLICKHOUSE_HOST}",
28+
"CLICKHOUSE_USER": "${input:CLICKHOUSE_USER}",
29+
"CLICKHOUSE_PASSWORD": "${input:CLICKHOUSE_PASSWORD}",
30+
"CLICKHOUSE_PORT": "${input:CLICKHOUSE_PORT}",
31+
"CLICKHOUSE_SECURE": "${input:CLICKHOUSE_SECURE}",
32+
"CLICKHOUSE_VERIFY": "${input:CLICKHOUSE_VERIFY}"
33+
},
34+
"metadata": {
35+
"inputs": [
36+
{
37+
"id": "CLICKHOUSE_HOST",
38+
"label": "ClickHouse Host",
39+
"description": "Hostname of your ClickHouse server. For ClickHouse Cloud, use the host shown in your service connection details (e.g. <service-id>.<region>.clickhouse.cloud).",
40+
"type": "text",
41+
"required": true,
42+
"secret": false,
43+
"placeholder": "your-instance.clickhouse.cloud",
44+
"obtain": {
45+
"url": "https://clickhouse.com/cloud",
46+
"instructions": "1. Sign in to ClickHouse Cloud\n2. Open your service\n3. Click 'Connect'\n4. Copy the host (and create a dedicated, least-privilege user for the MCP server)",
47+
"button_label": "Open ClickHouse Cloud"
48+
}
49+
},
50+
{
51+
"id": "CLICKHOUSE_USER",
52+
"label": "ClickHouse User",
53+
"description": "Username for authentication. Use a dedicated user with only the minimum privileges needed; avoid default or admin users.",
54+
"type": "text",
55+
"required": true,
56+
"secret": false,
57+
"placeholder": "default"
58+
},
59+
{
60+
"id": "CLICKHOUSE_PASSWORD",
61+
"label": "ClickHouse Password",
62+
"description": "Password for authentication. May be empty for some instances (e.g. the public ClickHouse SQL playground), but is required for most deployments.",
63+
"type": "text",
64+
"required": false,
65+
"secret": true,
66+
"placeholder": ""
67+
},
68+
{
69+
"id": "CLICKHOUSE_PORT",
70+
"label": "ClickHouse Port",
71+
"description": "Port of the ClickHouse HTTP interface. Defaults to 8443 when HTTPS (secure) is enabled and 8123 when disabled. Usually only set this for a non-standard port.",
72+
"type": "number",
73+
"required": false,
74+
"secret": false,
75+
"default": "8443",
76+
"placeholder": "8443"
77+
},
78+
{
79+
"id": "CLICKHOUSE_SECURE",
80+
"label": "Use HTTPS (Secure)",
81+
"description": "Enable an HTTPS (TLS) connection. Keep true for ClickHouse Cloud; set false for non-secure local connections.",
82+
"type": "boolean",
83+
"required": false,
84+
"secret": false,
85+
"default": "true"
86+
},
87+
{
88+
"id": "CLICKHOUSE_VERIFY",
89+
"label": "Verify SSL Certificate",
90+
"description": "Verify the server's SSL certificate. Keep true in production; set false only for self-signed certs in trusted environments.",
91+
"type": "boolean",
92+
"required": false,
93+
"secret": false,
94+
"default": "true"
95+
}
96+
]
97+
}
98+
},
99+
"auth": {
100+
"type": "optional_api_key",
101+
"instructions": "Provide your ClickHouse host, user, and password. The password can be empty for passwordless instances (e.g. the public ClickHouse SQL playground), but most deployments require one. Use a dedicated, least-privilege user."
102+
},
103+
"contributor": {
104+
"name": "ClickHouse",
105+
"github": "ClickHouse",
106+
"url": "https://clickhouse.com"
107+
},
108+
"links": {
109+
"repository": "https://github.com/ClickHouse/mcp-clickhouse",
110+
"homepage": "https://clickhouse.com",
111+
"documentation": "https://github.com/ClickHouse/mcp-clickhouse#readme"
112+
},
113+
"platforms": [
114+
"all"
115+
],
116+
"capabilities": {
117+
"tools": true,
118+
"resources": false,
119+
"prompts": false,
120+
"read_only_mode": true
121+
},
122+
"changelog_url": "https://github.com/ClickHouse/mcp-clickhouse/releases"
123+
}

0 commit comments

Comments
 (0)