Skip to content

Commit 30e8d50

Browse files
authored
Add instructions without uv (#65)
1 parent 9aa8188 commit 30e8d50

File tree

2 files changed

+72
-6
lines changed

2 files changed

+72
-6
lines changed

.python-version

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
3.13
1+
3.10

README.md

Lines changed: 71 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ This MCP server supports both ClickHouse and chDB. You can enable either or both
6161
"--with",
6262
"mcp-clickhouse",
6363
"--python",
64-
"3.13",
64+
"3.10",
6565
"mcp-clickhouse"
6666
],
6767
"env": {
@@ -93,7 +93,7 @@ Or, if you'd like to try it out with the [ClickHouse SQL Playground](https://sql
9393
"--with",
9494
"mcp-clickhouse",
9595
"--python",
96-
"3.13",
96+
"3.10",
9797
"mcp-clickhouse"
9898
],
9999
"env": {
@@ -123,7 +123,7 @@ For chDB (embedded OLAP engine), add the following configuration:
123123
"--with",
124124
"mcp-clickhouse",
125125
"--python",
126-
"3.13",
126+
"3.10",
127127
"mcp-clickhouse"
128128
],
129129
"env": {
@@ -148,7 +148,7 @@ You can also enable both ClickHouse and chDB simultaneously:
148148
"--with",
149149
"mcp-clickhouse",
150150
"--python",
151-
"3.13",
151+
"3.10",
152152
"mcp-clickhouse"
153153
],
154154
"env": {
@@ -172,6 +172,72 @@ You can also enable both ClickHouse and chDB simultaneously:
172172

173173
4. Restart Claude Desktop to apply the changes.
174174

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+
175241
## Development
176242

177243
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
344410
"--with",
345411
"mcp-clickhouse",
346412
"--python",
347-
"3.13",
413+
"3.10",
348414
"mcp-clickhouse"
349415
],
350416
"env": {

0 commit comments

Comments
 (0)