mcp-server-motherduck 0.6.2__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.2 → mcp_server_motherduck-0.6.4}/.idea/workspace.xml +2 -7
  2. mcp_server_motherduck-0.6.2/README.md → mcp_server_motherduck-0.6.4/PKG-INFO +59 -2
  3. mcp_server_motherduck-0.6.2/PKG-INFO → mcp_server_motherduck-0.6.4/README.md +42 -18
  4. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/pyproject.toml +2 -1
  5. mcp_server_motherduck-0.6.4/server.json +31 -0
  6. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/configs.py +1 -1
  7. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/uv.lock +12 -1
  8. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.github/workflows/python-publish.yml +0 -0
  9. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.gitignore +0 -0
  10. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.idea/.gitignore +0 -0
  11. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.idea/mcp-server-motherduck.iml +0 -0
  12. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.idea/misc.xml +0 -0
  13. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.idea/modules.xml +0 -0
  14. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/.idea/vcs.xml +0 -0
  15. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/LICENSE +0 -0
  16. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/makefile +0 -0
  17. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/__init__.py +0 -0
  18. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/database.py +0 -0
  19. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/prompt.py +0 -0
  20. {mcp_server_motherduck-0.6.2 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/server.py +0 -0
@@ -12,12 +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$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
17
- <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
18
- <change beforePath="$PROJECT_DIR$/src/mcp_server_motherduck/configs.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/mcp_server_motherduck/configs.py" afterDir="false" />
19
- <change beforePath="$PROJECT_DIR$/src/mcp_server_motherduck/database.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/mcp_server_motherduck/database.py" afterDir="false" />
20
- </list>
15
+ <list default="true" id="8bdee1d4-886c-4093-b4cf-95b120034c9e" name="Changes" comment="" />
21
16
  <option name="SHOW_DIALOG" value="false" />
22
17
  <option name="HIGHLIGHT_CONFLICTS" value="true" />
23
18
  <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
@@ -97,7 +92,7 @@
97
92
  <workItem from="1750084439422" duration="575000" />
98
93
  <workItem from="1750086684829" duration="92000" />
99
94
  <workItem from="1750099676834" duration="5651000" />
100
- <workItem from="1750235697329" duration="2124000" />
95
+ <workItem from="1750235697329" duration="4120000" />
101
96
  </task>
102
97
  <servers />
103
98
  </component>
@@ -1,8 +1,25 @@
1
+ Metadata-Version: 2.4
2
+ Name: mcp-server-motherduck
3
+ Version: 0.6.4
4
+ Summary: A MCP server for MotherDuck and local DuckDB
5
+ Author-email: tdoehmen <till@motherduck.com>
6
+ License-File: LICENSE
7
+ Requires-Python: >=3.10
8
+ Requires-Dist: anyio>=4.8.0
9
+ Requires-Dist: click>=8.1.8
10
+ Requires-Dist: duckdb==1.3.1
11
+ Requires-Dist: mcp>=1.9.4
12
+ Requires-Dist: pytz>=2025.2
13
+ Requires-Dist: starlette>=0.46.1
14
+ Requires-Dist: tabulate>=0.9.0
15
+ Requires-Dist: uvicorn>=0.34.0
16
+ Description-Content-Type: text/markdown
17
+
1
18
  # MotherDuck's DuckDB MCP Server
2
19
 
3
20
  An MCP server implementation that interacts with DuckDB and MotherDuck databases, providing SQL analytics capabilities to AI Assistants and IDEs.
4
21
 
5
- [![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)
6
23
 
7
24
  ## Resources
8
25
  - [Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost)](https://motherduck.com/blog/faster-data-pipelines-with-mcp-duckdb-ai/)
@@ -205,7 +222,44 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
205
222
  **Important Notes**:
206
223
 
207
224
  - Replace `YOUR_MOTHERDUCK_TOKEN_HERE` with your actual MotherDuck token
208
- - The `HOME` environment variable is required for DuckDB to function properly.
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
209
263
 
210
264
  ## Securing your MCP Server when querying MotherDuck
211
265
 
@@ -368,3 +422,6 @@ To run the server from a local development environment, use the following config
368
422
  ## License
369
423
 
370
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
@@ -1,24 +1,8 @@
1
- Metadata-Version: 2.4
2
- Name: mcp-server-motherduck
3
- Version: 0.6.2
4
- Summary: A MCP server for MotherDuck and local DuckDB
5
- Author-email: tdoehmen <till@motherduck.com>
6
- License-File: LICENSE
7
- Requires-Python: >=3.10
8
- Requires-Dist: anyio>=4.8.0
9
- Requires-Dist: click>=8.1.8
10
- Requires-Dist: duckdb==1.3.1
11
- Requires-Dist: mcp>=1.9.4
12
- Requires-Dist: starlette>=0.46.1
13
- Requires-Dist: tabulate>=0.9.0
14
- Requires-Dist: uvicorn>=0.34.0
15
- Description-Content-Type: text/markdown
16
-
17
1
  # MotherDuck's DuckDB MCP Server
18
2
 
19
3
  An MCP server implementation that interacts with DuckDB and MotherDuck databases, providing SQL analytics capabilities to AI Assistants and IDEs.
20
4
 
21
- [![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)
22
6
 
23
7
  ## Resources
24
8
  - [Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost)](https://motherduck.com/blog/faster-data-pipelines-with-mcp-duckdb-ai/)
@@ -221,7 +205,44 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
221
205
  **Important Notes**:
222
206
 
223
207
  - Replace `YOUR_MOTHERDUCK_TOKEN_HERE` with your actual MotherDuck token
224
- - The `HOME` environment variable is required for DuckDB to function properly.
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
225
246
 
226
247
  ## Securing your MCP Server when querying MotherDuck
227
248
 
@@ -384,3 +405,6 @@ To run the server from a local development environment, use the following config
384
405
  ## License
385
406
 
386
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.2"
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"
@@ -12,6 +12,7 @@ dependencies = [
12
12
  "uvicorn>=0.34.0",
13
13
  "anyio>=4.8.0",
14
14
  "mcp>=1.9.4",
15
+ "pytz>=2025.2"
15
16
  ]
16
17
 
17
18
  [[project.authors]]
@@ -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.2"
3
+ SERVER_VERSION = "0.6.4"
4
4
 
5
5
  SERVER_LOCALHOST = "127.0.0.1"
6
6
 
@@ -182,13 +182,14 @@ wheels = [
182
182
 
183
183
  [[package]]
184
184
  name = "mcp-server-motherduck"
185
- version = "0.6.2"
185
+ version = "0.6.4"
186
186
  source = { editable = "." }
187
187
  dependencies = [
188
188
  { name = "anyio" },
189
189
  { name = "click" },
190
190
  { name = "duckdb" },
191
191
  { name = "mcp" },
192
+ { name = "pytz" },
192
193
  { name = "starlette" },
193
194
  { name = "tabulate" },
194
195
  { name = "uvicorn" },
@@ -200,6 +201,7 @@ requires-dist = [
200
201
  { name = "click", specifier = ">=8.1.8" },
201
202
  { name = "duckdb", specifier = "==1.3.1" },
202
203
  { name = "mcp", specifier = ">=1.9.4" },
204
+ { name = "pytz", specifier = ">=2025.2" },
203
205
  { name = "starlette", specifier = ">=0.46.1" },
204
206
  { name = "tabulate", specifier = ">=0.9.0" },
205
207
  { name = "uvicorn", specifier = ">=0.34.0" },
@@ -339,6 +341,15 @@ wheels = [
339
341
  { url = "https://files.pythonhosted.org/packages/45/58/38b5afbc1a800eeea951b9285d3912613f2603bdf897a4ab0f4bd7f405fc/python_multipart-0.0.20-py3-none-any.whl", hash = "sha256:8a62d3a8335e06589fe01f2a3e178cdcc632f3fbe0d492ad9ee0ec35aab1f104", size = 24546 },
340
342
  ]
341
343
 
344
+ [[package]]
345
+ name = "pytz"
346
+ version = "2025.2"
347
+ source = { registry = "https://pypi.org/simple" }
348
+ sdist = { url = "https://files.pythonhosted.org/packages/f8/bf/abbd3cdfb8fbc7fb3d4d38d320f2441b1e7cbe29be4f23797b4a2b5d8aac/pytz-2025.2.tar.gz", hash = "sha256:360b9e3dbb49a209c21ad61809c7fb453643e048b38924c765813546746e81c3", size = 320884 }
349
+ wheels = [
350
+ { url = "https://files.pythonhosted.org/packages/81/c4/34e93fe5f5429d7570ec1fa436f1986fb1f00c3e0f43a589fe2bbcd22c3f/pytz-2025.2-py2.py3-none-any.whl", hash = "sha256:5ddf76296dd8c44c26eb8f4b6f35488f3ccbf6fbbd7adee0b7262d43f0ec2f00", size = 509225 },
351
+ ]
352
+
342
353
  [[package]]
343
354
  name = "sniffio"
344
355
  version = "1.3.1"