mcp-server-motherduck 0.6.3__tar.gz → 0.6.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of mcp-server-motherduck might be problematic. Click here for more details.

Files changed (20) hide show
  1. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/workspace.xml +2 -5
  2. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/PKG-INFO +43 -2
  3. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/README.md +42 -1
  4. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/pyproject.toml +1 -1
  5. mcp_server_motherduck-0.6.4/server.json +31 -0
  6. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/configs.py +1 -1
  7. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/uv.lock +1 -1
  8. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.github/workflows/python-publish.yml +0 -0
  9. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.gitignore +0 -0
  10. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/.gitignore +0 -0
  11. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/mcp-server-motherduck.iml +0 -0
  12. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/misc.xml +0 -0
  13. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/modules.xml +0 -0
  14. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/vcs.xml +0 -0
  15. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/LICENSE +0 -0
  16. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/makefile +0 -0
  17. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/__init__.py +0 -0
  18. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/database.py +0 -0
  19. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/prompt.py +0 -0
  20. {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/server.py +0 -0
@@ -12,10 +12,7 @@
12
12
  </configurations>
13
13
  </component>
14
14
  <component name="ChangeListManager">
15
- <list default="true" id="8bdee1d4-886c-4093-b4cf-95b120034c9e" name="Changes" comment="">
16
- <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
17
- <change beforePath="$PROJECT_DIR$/src/mcp_server_motherduck/configs.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/mcp_server_motherduck/configs.py" afterDir="false" />
18
- </list>
15
+ <list default="true" id="8bdee1d4-886c-4093-b4cf-95b120034c9e" name="Changes" comment="" />
19
16
  <option name="SHOW_DIALOG" value="false" />
20
17
  <option name="HIGHLIGHT_CONFLICTS" value="true" />
21
18
  <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
@@ -95,7 +92,7 @@
95
92
  <workItem from="1750084439422" duration="575000" />
96
93
  <workItem from="1750086684829" duration="92000" />
97
94
  <workItem from="1750099676834" duration="5651000" />
98
- <workItem from="1750235697329" duration="4118000" />
95
+ <workItem from="1750235697329" duration="4120000" />
99
96
  </task>
100
97
  <servers />
101
98
  </component>
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-server-motherduck
3
- Version: 0.6.3
3
+ Version: 0.6.4
4
4
  Summary: A MCP server for MotherDuck and local DuckDB
5
5
  Author-email: tdoehmen <till@motherduck.com>
6
6
  License-File: LICENSE
@@ -19,7 +19,7 @@ Description-Content-Type: text/markdown
19
19
 
20
20
  An MCP server implementation that interacts with DuckDB and MotherDuck databases, providing SQL analytics capabilities to AI Assistants and IDEs.
21
21
 
22
- [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=DuckDB&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItbW90aGVyZHVjayAtLWRiLXBhdGggbWQ6IiwiZW52Ijp7Im1vdGhlcmR1Y2tfdG9rZW4iOiIifX0%3D)
22
+ [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=DuckDB&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItbW90aGVyZHVjayAtLWRiLXBhdGggOm1lbW9yeToiLCJlbnYiOnsibW90aGVyZHVja190b2tlbiI6IiJ9fQ%3D%3D)
23
23
 
24
24
  ## Resources
25
25
  - [Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost)](https://motherduck.com/blog/faster-data-pipelines-with-mcp-duckdb-ai/)
@@ -223,6 +223,44 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
223
223
 
224
224
  - Replace `YOUR_MOTHERDUCK_TOKEN_HERE` with your actual MotherDuck token
225
225
 
226
+ ### Usage with Claude Code
227
+
228
+ Claude Code supports MCP servers through CLI commands or JSON configuration. Here are two ways to set it up:
229
+
230
+ #### Option 1: Using CLI Commands
231
+
232
+ Add the MotherDuck MCP server directly using the Claude Code CLI:
233
+
234
+ ```bash
235
+ claude mcp add mcp-server-motherduck uvx mcp-server-motherduck -- --db-path md: --motherduck-token <YOUR_MOTHERDUCK_TOKEN_HERE>
236
+ ```
237
+
238
+ #### Option 2: Using JSON Configuration
239
+
240
+ Add the server using a JSON configuration:
241
+
242
+ ```bash
243
+ claude mcp add-json mcp-server-motherduck '{
244
+ "command": "uvx",
245
+ "args": [
246
+ "mcp-server-motherduck",
247
+ "--db-path",
248
+ "md:",
249
+ "--motherduck-token",
250
+ "<YOUR_MOTHERDUCK_TOKEN_HERE>"
251
+ ]
252
+ }'
253
+ ```
254
+
255
+ **Scoping Options**:
256
+ - Use `--local` (default) for project-specific configuration
257
+ - Use `--project` to share the configuration with your team via `.mcp.json`
258
+ - Use `--user` to make the server available across all your projects
259
+
260
+ **Important Notes**:
261
+ - Replace `YOUR_MOTHERDUCK_TOKEN_HERE` with your actual MotherDuck token
262
+ - Claude Code also supports environment variable expansion, so you can use `${MOTHERDUCK_TOKEN}` if you've set the environment variable
263
+
226
264
  ## Securing your MCP Server when querying MotherDuck
227
265
 
228
266
  If the MCP server is exposed to third parties and should only have read access to data, we recommend using a read scaling token and running the MCP server in SaaS mode.
@@ -384,3 +422,6 @@ To run the server from a local development environment, use the following config
384
422
  ## License
385
423
 
386
424
  This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
425
+
426
+ ##
427
+ mcp-name: io.github.motherduckdb/mcp-server-motherduck
@@ -2,7 +2,7 @@
2
2
 
3
3
  An MCP server implementation that interacts with DuckDB and MotherDuck databases, providing SQL analytics capabilities to AI Assistants and IDEs.
4
4
 
5
- [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=DuckDB&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItbW90aGVyZHVjayAtLWRiLXBhdGggbWQ6IiwiZW52Ijp7Im1vdGhlcmR1Y2tfdG9rZW4iOiIifX0%3D)
5
+ [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=DuckDB&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItbW90aGVyZHVjayAtLWRiLXBhdGggOm1lbW9yeToiLCJlbnYiOnsibW90aGVyZHVja190b2tlbiI6IiJ9fQ%3D%3D)
6
6
 
7
7
  ## Resources
8
8
  - [Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost)](https://motherduck.com/blog/faster-data-pipelines-with-mcp-duckdb-ai/)
@@ -206,6 +206,44 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
206
206
 
207
207
  - Replace `YOUR_MOTHERDUCK_TOKEN_HERE` with your actual MotherDuck token
208
208
 
209
+ ### Usage with Claude Code
210
+
211
+ Claude Code supports MCP servers through CLI commands or JSON configuration. Here are two ways to set it up:
212
+
213
+ #### Option 1: Using CLI Commands
214
+
215
+ Add the MotherDuck MCP server directly using the Claude Code CLI:
216
+
217
+ ```bash
218
+ claude mcp add mcp-server-motherduck uvx mcp-server-motherduck -- --db-path md: --motherduck-token <YOUR_MOTHERDUCK_TOKEN_HERE>
219
+ ```
220
+
221
+ #### Option 2: Using JSON Configuration
222
+
223
+ Add the server using a JSON configuration:
224
+
225
+ ```bash
226
+ claude mcp add-json mcp-server-motherduck '{
227
+ "command": "uvx",
228
+ "args": [
229
+ "mcp-server-motherduck",
230
+ "--db-path",
231
+ "md:",
232
+ "--motherduck-token",
233
+ "<YOUR_MOTHERDUCK_TOKEN_HERE>"
234
+ ]
235
+ }'
236
+ ```
237
+
238
+ **Scoping Options**:
239
+ - Use `--local` (default) for project-specific configuration
240
+ - Use `--project` to share the configuration with your team via `.mcp.json`
241
+ - Use `--user` to make the server available across all your projects
242
+
243
+ **Important Notes**:
244
+ - Replace `YOUR_MOTHERDUCK_TOKEN_HERE` with your actual MotherDuck token
245
+ - Claude Code also supports environment variable expansion, so you can use `${MOTHERDUCK_TOKEN}` if you've set the environment variable
246
+
209
247
  ## Securing your MCP Server when querying MotherDuck
210
248
 
211
249
  If the MCP server is exposed to third parties and should only have read access to data, we recommend using a read scaling token and running the MCP server in SaaS mode.
@@ -367,3 +405,6 @@ To run the server from a local development environment, use the following config
367
405
  ## License
368
406
 
369
407
  This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
408
+
409
+ ##
410
+ mcp-name: io.github.motherduckdb/mcp-server-motherduck
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "mcp-server-motherduck"
3
- version = "0.6.3"
3
+ version = "0.6.4"
4
4
  description = "A MCP server for MotherDuck and local DuckDB"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.10"
@@ -0,0 +1,31 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
3
+ "name": "io.github.motherduckdb/mcp-server-motherduck",
4
+ "description": "Fast analytics and data processing with DuckDB and MotherDuck",
5
+ "status": "active",
6
+ "repository": {
7
+ "url": "https://github.com/motherduckdb/mcp-server-motherduck",
8
+ "source": "github"
9
+ },
10
+ "version": "0.6.4",
11
+ "packages": [
12
+ {
13
+ "registry_type": "pypi",
14
+ "registry_base_url": "https://pypi.org",
15
+ "identifier": "mcp-server-motherduck",
16
+ "version": "0.6.4",
17
+ "transport": {
18
+ "type": "stdio"
19
+ },
20
+ "environment_variables": [
21
+ {
22
+ "description": "Access token to use for MotherDuck database connections",
23
+ "is_required": false,
24
+ "format": "string",
25
+ "is_secret": true,
26
+ "name": "motherduck_token"
27
+ }
28
+ ]
29
+ }
30
+ ]
31
+ }
@@ -1,6 +1,6 @@
1
1
  from typing import Any
2
2
 
3
- SERVER_VERSION = "0.6.3"
3
+ SERVER_VERSION = "0.6.4"
4
4
 
5
5
  SERVER_LOCALHOST = "127.0.0.1"
6
6
 
@@ -182,7 +182,7 @@ wheels = [
182
182
 
183
183
  [[package]]
184
184
  name = "mcp-server-motherduck"
185
- version = "0.6.3"
185
+ version = "0.6.4"
186
186
  source = { editable = "." }
187
187
  dependencies = [
188
188
  { name = "anyio" },