You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+71-5Lines changed: 71 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -61,7 +61,7 @@ This MCP server supports both ClickHouse and chDB. You can enable either or both
61
61
"--with",
62
62
"mcp-clickhouse",
63
63
"--python",
64
-
"3.13",
64
+
"3.10",
65
65
"mcp-clickhouse"
66
66
],
67
67
"env": {
@@ -93,7 +93,7 @@ Or, if you'd like to try it out with the [ClickHouse SQL Playground](https://sql
93
93
"--with",
94
94
"mcp-clickhouse",
95
95
"--python",
96
-
"3.13",
96
+
"3.10",
97
97
"mcp-clickhouse"
98
98
],
99
99
"env": {
@@ -123,7 +123,7 @@ For chDB (embedded OLAP engine), add the following configuration:
123
123
"--with",
124
124
"mcp-clickhouse",
125
125
"--python",
126
-
"3.13",
126
+
"3.10",
127
127
"mcp-clickhouse"
128
128
],
129
129
"env": {
@@ -148,7 +148,7 @@ You can also enable both ClickHouse and chDB simultaneously:
148
148
"--with",
149
149
"mcp-clickhouse",
150
150
"--python",
151
-
"3.13",
151
+
"3.10",
152
152
"mcp-clickhouse"
153
153
],
154
154
"env": {
@@ -172,6 +172,72 @@ You can also enable both ClickHouse and chDB simultaneously:
172
172
173
173
4. Restart Claude Desktop to apply the changes.
174
174
175
+
### Running Without uv (Using System Python)
176
+
177
+
If you prefer to use the system Python installation instead of uv, you can install the package from PyPI and run it directly:
178
+
179
+
1. Install the package using pip:
180
+
```bash
181
+
python3 -m pip install mcp-clickhouse
182
+
```
183
+
184
+
To upgrade to the latest version:
185
+
```bash
186
+
python3 -m pip install --upgrade mcp-clickhouse
187
+
```
188
+
189
+
2. Update your Claude Desktop configuration to use Python directly:
190
+
191
+
```json
192
+
{
193
+
"mcpServers": {
194
+
"mcp-clickhouse": {
195
+
"command": "python3",
196
+
"args": [
197
+
"-m",
198
+
"mcp_clickhouse.main"
199
+
],
200
+
"env": {
201
+
"CLICKHOUSE_HOST": "<clickhouse-host>",
202
+
"CLICKHOUSE_PORT": "<clickhouse-port>",
203
+
"CLICKHOUSE_USER": "<clickhouse-user>",
204
+
"CLICKHOUSE_PASSWORD": "<clickhouse-password>",
205
+
"CLICKHOUSE_SECURE": "true",
206
+
"CLICKHOUSE_VERIFY": "true",
207
+
"CLICKHOUSE_CONNECT_TIMEOUT": "30",
208
+
"CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
209
+
}
210
+
}
211
+
}
212
+
}
213
+
```
214
+
215
+
Alternatively, you can use the installed script directly:
216
+
217
+
```json
218
+
{
219
+
"mcpServers": {
220
+
"mcp-clickhouse": {
221
+
"command": "mcp-clickhouse",
222
+
"env": {
223
+
"CLICKHOUSE_HOST": "<clickhouse-host>",
224
+
"CLICKHOUSE_PORT": "<clickhouse-port>",
225
+
"CLICKHOUSE_USER": "<clickhouse-user>",
226
+
"CLICKHOUSE_PASSWORD": "<clickhouse-password>",
227
+
"CLICKHOUSE_SECURE": "true",
228
+
"CLICKHOUSE_VERIFY": "true",
229
+
"CLICKHOUSE_CONNECT_TIMEOUT": "30",
230
+
"CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
231
+
}
232
+
}
233
+
}
234
+
}
235
+
```
236
+
237
+
Note: Make sure to use the full path to the Python executable or the `mcp-clickhouse` script if they are not in your system PATH. You can find the paths using:
238
+
-`which python3` for the Python executable
239
+
-`which mcp-clickhouse` for the installed script
240
+
175
241
## Development
176
242
177
243
1. In `test-services` directory run `docker compose up -d` to start the ClickHouse cluster.
@@ -344,7 +410,7 @@ You can set these variables in your environment, in a `.env` file, or in the Cla
0 commit comments