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.
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/workspace.xml +2 -5
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/PKG-INFO +43 -2
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/README.md +42 -1
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/pyproject.toml +1 -1
- mcp_server_motherduck-0.6.4/server.json +31 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/configs.py +1 -1
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/uv.lock +1 -1
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.github/workflows/python-publish.yml +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.gitignore +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/.gitignore +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/mcp-server-motherduck.iml +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/misc.xml +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/modules.xml +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.idea/vcs.xml +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/LICENSE +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/makefile +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/__init__.py +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/database.py +0 -0
- {mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/prompt.py +0 -0
- {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="
|
|
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
|
+
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
|
-
[](
|
|
22
|
+
[](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
|
-
[](
|
|
5
|
+
[](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
|
|
@@ -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
|
+
}
|
{mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/.github/workflows/python-publish.yml
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/__init__.py
RENAMED
|
File without changes
|
{mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/database.py
RENAMED
|
File without changes
|
{mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/prompt.py
RENAMED
|
File without changes
|
{mcp_server_motherduck-0.6.3 → mcp_server_motherduck-0.6.4}/src/mcp_server_motherduck/server.py
RENAMED
|
File without changes
|