PyPI - mcp-server-motherduck - Versions diffs - 0.4.1__tar.gz → 0.4.3__tar.gz - Mend

mcp-server-motherduck 0.4.1tar.gz → 0.4.3tar.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.

Files changed (17) hide show

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/.idea/misc.xml RENAMED Viewed

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ProjectRootManager" version="2" languageLevel="JDK_20" project-jdk-name="Python 3.11" project-jdk-type="Python SDK">
     <output url="file://$PROJECT_DIR$/out" />

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/.idea/workspace.xml RENAMED Viewed

@@ -4,7 +4,7 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="5f5ca33d-24b5-4ccd-b2b3-3ff0b492aff6" name="Changes" comment="">
+    <list default="true" id="8bdee1d4-886c-4093-b4cf-95b120034c9e" name="Changes" comment="">
       <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/src/mcp_server_motherduck/server.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/mcp_server_motherduck/server.py" afterDir="false" />
     </list>
@@ -20,9 +20,9 @@
     <option name="stateVersion" value="1" />
   </component>
   <component name="ProjectColorInfo">{
-  &quot;associatedIndex&quot;: 1
+  &quot;associatedIndex&quot;: 3
 }</component>
-  <component name="ProjectId" id="2u5xTlafNwhlw0HAUWKYPjo4ax8" />
+  <component name="ProjectId" id="2vcb2orYlzlw5ZHOvoXgpTtCdVi" />
   <component name="ProjectViewState">
     <option name="hideEmptyMiddlePackages" value="true" />
     <option name="showLibraryContents" value="true" />
@@ -33,7 +33,7 @@
     &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
     &quot;WebServerToolWindowFactoryState&quot;: &quot;false&quot;,
     &quot;git-widget-placeholder&quot;: &quot;main&quot;,
-    &quot;last_opened_file_path&quot;: &quot;/Users/doehmen/Documents/Research/docs/ai-playground/mcp-server/github_md/mcp-server-motherduck&quot;,
+    &quot;last_opened_file_path&quot;: &quot;/Users/doehmen/Documents/motherduck/mcp-server-motherduck&quot;,
     &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
     &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
     &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
@@ -48,14 +48,15 @@
   <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
   <component name="TaskManager">
     <task active="true" id="Default" summary="Default task">
-      <changelist id="5f5ca33d-24b5-4ccd-b2b3-3ff0b492aff6" name="Changes" comment="" />
-      <created>1741552248367</created>
+      <changelist id="8bdee1d4-886c-4093-b4cf-95b120034c9e" name="Changes" comment="" />
+      <created>1744447105618</created>
       <option name="number" value="Default" />
       <option name="presentableId" value="Default" />
-      <updated>1741552248367</updated>
-      <workItem from="1741552249680" duration="3949000" />
-      <workItem from="1741799556448" duration="2256000" />
-      <workItem from="1742223629669" duration="5595000" />
+      <updated>1744447105618</updated>
+      <workItem from="1744447107447" duration="7470000" />
+      <workItem from="1744787944049" duration="599000" />
+      <workItem from="1744896732489" duration="6070000" />
+      <workItem from="1747725447463" duration="540000" />
     </task>
     <servers />
   </component>

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/PKG-INFO RENAMED Viewed

@@ -1,26 +1,30 @@
 Metadata-Version: 2.4
 Name: mcp-server-motherduck
-Version: 0.4.1
+Version: 0.4.3
 Summary: A MCP server for MotherDuck and local DuckDB
 Author-email: tdoehmen <till@motherduck.com>
 License-File: LICENSE
 Requires-Python: >=3.10
-Requires-Dist: duckdb==1.2.1
+Requires-Dist: duckdb==1.2.2
 Requires-Dist: mcp>=1.3.0
 Requires-Dist: pandas>=2.0.0
 Requires-Dist: tabulate>=0.9.0
 Description-Content-Type: text/markdown
-# MotherDuck MCP Server
+# MotherDuck's DuckDB MCP Server
-An MCP server implementation that integrates MotherDuck and local DuckDB, providing SQL analytics capabilities to Claude.
+An MCP server implementation that interacts with DuckDB and MotherDuck databases, providing SQL analytics capabilities to AI Assistants and IDEs.
+## Resources
+- [Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost)](https://motherduck.com/blog/faster-data-pipelines-with-mcp-duckdb-ai/)
+- [Faster Data Pipelines development with MCP and DuckDB (YouTube)](https://www.youtube.com/watch?v=yG1mv8ZRxcU)
 ## Features
-- **Hybrid execution**: query data from both cloud-based MotherDuck and local DuckDB
+- **Hybrid execution**: query data from local DuckDB or/and cloud-based MotherDuck databases
 - **Cloud storage integration**: access data stored in Amazon S3 or other cloud storage thanks to MotherDuck's integrations
 - **Data sharing**: create and share databases
-- **SQL analytics**: use DuckDB's SQL dialect to query any size of data directly from Claude
+- **SQL analytics**: use DuckDB's SQL dialect to query any size of data directly from your AI Assistant or IDE
 - **Serverless architecture**: run analytics without needing to configure instances or clusters
 ## Components
@@ -35,7 +39,7 @@ The server provides one prompt:
 The server offers one tool:
-- `query`: Execute a SQL query on the MotherDuck/DuckDB database
+- `query`: Execute a SQL query on the DuckDB or MotherDuck database
   - **Inputs**:
     - `query` (string, required): The SQL query to execute
@@ -43,23 +47,55 @@ All interactions with both DuckDB and MotherDuck are done through writing SQL qu
 ## Getting Started
-### Prerequisites
+### General Prerequisites
-- A MotherDuck account (sign up at [motherduck.com](https://motherduck.com))
-- A MotherDuck access token
 - `uv` installed, you can install it using `pip install uv` or `brew install uv`
-If you plan to use MotherDuck MCP with Claude Desktop, you will also need Claude Desktop installed.
+If you plan to use the MCP with Claude Desktop or any other MCP comptabile client, the client need to be installed.
+### Prerequisites for DuckDB
+- No prerequisites. The MCP server can create an in-memory database on-the-fly
+- Or connect to an existing local DuckDB database file , or one stored on remote object storage (e.g., AWS S3).
+See [Connect to local DuckDB](#connect-to-local-duckdb).
+### Prerequisites for MotherDuck
+- Sign up for a [MotherDuck account](https://app.motherduck.com/?auth_flow=signup)
+- Generate an access token via the [MotherDuck UI](https://app.motherduck.com/settings/tokens?auth_flow=signup)
+- Store the token securely for use in the configuration
+### Usage with Cursor
+1. Install Cursor from [cursor.com/downloads](https://www.cursor.com/downloads) if you haven't already
-### Setting up your MotherDuck token
+2. Open Cursor:
-1. Sign up for a [MotherDuck account](https://app.motherduck.com/?auth_flow=signup)
-2. Generate an access token via the [MotherDuck UI](https://app.motherduck.com/settings/tokens?auth_flow=signup)
-3. Store the token securely for use in the configuration
+- To set it up globally for the first time, go to Settings->MCP and click on "+ Add new global MCP server".
+- This will open a `mcp.json` file to which you add the following configuration:
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "md:",
+        "--motherduck-token",
+        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
+      ]
+    }
+  }
+}
+```
 ### Usage with VS Code
 [![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=mcp-server-motherduck&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-motherduck%22%2C%22--db-path%22%2C%22md%3A%22%2C%22--motherduck-token%22%2C%22%24%7Binput%3Amotherduck_token%7D%22%5D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22motherduck_token%22%2C%22description%22%3A%22MotherDuck+Token%22%2C%22password%22%3Atrue%7D%5D) [![Install with UV in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-UV-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=mcp-server-motherduck&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-motherduck%22%2C%22--db-path%22%2C%22md%3A%22%2C%22--motherduck-token%22%2C%22%24%7Binput%3Amotherduck_token%7D%22%5D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22motherduck_token%22%2C%22description%22%3A%22MotherDuck+Token%22%2C%22password%22%3Atrue%7D%5D&quality=insiders)
 1. For the quickest installation, click one of the "Install with UV" buttons at the top of this README.
 ### Manual Installation
@@ -140,7 +176,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
         "md:",
         "--motherduck-token",
         "<YOUR_MOTHERDUCK_TOKEN_HERE>"
-      ],
+      ]
     }
   }
 }
@@ -152,9 +188,102 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
 - Replace `YOUR_HOME_FOLDER_PATH` with the path to your home directory (needed by DuckDB for file operations). For example, on macOS, it would be `/Users/your_username`
 - The `HOME` environment variable is required for DuckDB to function properly.
+## Securing your MCP Server when querying MotherDuck
+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.
+**Read Scaling Tokens** are special access tokens that enable scalable read operations by allowing up to 4 concurrent read replicas, improving performance for multiple end users while *restricting write capabilities*.
+Refer to the [Read Scaling documentation](https://motherduck.com/docs/key-tasks/authenticating-and-connecting-to-motherduck/read-scaling/#creating-a-read-scaling-token) to learn how to create a read-scaling token.
+**SaaS Mode** in MotherDuck enhances security by restricting it's access to local files, databases, extensions, and configurations, making it ideal for third-party tools that require stricter environment protection. Learn more about it in the [SaaS Mode documentation](https://motherduck.com/docs/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck/#authentication-using-saas-mode).
+**Secure Configuration**
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "md:",
+        "--motherduck-token",
+        "<YOUR_READ_SCALING_TOKEN_HERE>",
+        "--saas-mode"
+      ]
+    }
+  }
+}
+```
+## Connect to local DuckDB
+To connect to a local DuckDB, instead of using the MotherDuck token, specify the path to your local DuckDB database file or use `:memory:` for an in-memory database.
+In-memory database:
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        ":memory:"
+      ]
+    }
+  }
+}
+```
+Local DuckDB file:
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "/path/to/your/local.db"
+      ]
+    }
+  }
+}
+```
+Local DuckDB file in [readonly mode](https://duckdb.org/docs/stable/connect/concurrency.html):
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "/path/to/your/local.db",
+        "--read-only"
+      ]
+    }
+  }
+}
+```
+**Note**: readonly mode for local file-backed DuckDB connections also makes use of
+short lived connections. Each time the query MCP tool is used a temporary,
+reaodnly connection is created + query is executed + connection is closed. This
+feature was motivated by a workflow where [DBT](https://www.getdbt.com) was for
+modeling data within duckdb and then an MCP client (Windsurf/Cline/Claude/Cursor)
+was used for exploring the database. The short lived connections allow each tool
+to run and then release their connection, allowing the next tool to connect.
 ## Example Queries
-Once configured, you can ask Claude to run queries like:
+Once configured, you can e.g. ask Claude to run queries like:
 - "Create a new database and table in MotherDuck"
 - "Query data from my local CSV file"
@@ -195,7 +324,7 @@ If you don't specify a database path but have set the `motherduck_token` environ
 ## Running in SSE mode
-The server could also be run ing SSE mode using `supergateway` by running the following command:
+The server could also be running SSE mode using `supergateway` by running the following command:
 ```bash
 npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>"
@@ -203,6 +332,30 @@ npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduc
 And you can point your clients such as Claude Desktop, Cursor to this endpoint.
+## Development configuration
+To run the server from a local development environment, use the following configuration:
+```json
+ {
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/path/to/your/local/mcp-server-motherduck",
+        "run",
+        "mcp-server-motherduck",
+        "--db-path",
+        "md:",
+        "--motherduck-token",
+        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
+      ]
+    }
+  }
+}
+```
 ## Troubleshooting
 - If you encounter connection issues, verify your MotherDuck token is correct

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/README.md RENAMED Viewed

@@ -1,13 +1,17 @@
-# MotherDuck MCP Server
+# MotherDuck's DuckDB MCP Server
-An MCP server implementation that integrates MotherDuck and local DuckDB, providing SQL analytics capabilities to Claude.
+An MCP server implementation that interacts with DuckDB and MotherDuck databases, providing SQL analytics capabilities to AI Assistants and IDEs.
+## Resources
+- [Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost)](https://motherduck.com/blog/faster-data-pipelines-with-mcp-duckdb-ai/)
+- [Faster Data Pipelines development with MCP and DuckDB (YouTube)](https://www.youtube.com/watch?v=yG1mv8ZRxcU)
 ## Features
-- **Hybrid execution**: query data from both cloud-based MotherDuck and local DuckDB
+- **Hybrid execution**: query data from local DuckDB or/and cloud-based MotherDuck databases
 - **Cloud storage integration**: access data stored in Amazon S3 or other cloud storage thanks to MotherDuck's integrations
 - **Data sharing**: create and share databases
-- **SQL analytics**: use DuckDB's SQL dialect to query any size of data directly from Claude
+- **SQL analytics**: use DuckDB's SQL dialect to query any size of data directly from your AI Assistant or IDE
 - **Serverless architecture**: run analytics without needing to configure instances or clusters
 ## Components
@@ -22,7 +26,7 @@ The server provides one prompt:
 The server offers one tool:
-- `query`: Execute a SQL query on the MotherDuck/DuckDB database
+- `query`: Execute a SQL query on the DuckDB or MotherDuck database
   - **Inputs**:
     - `query` (string, required): The SQL query to execute
@@ -30,23 +34,55 @@ All interactions with both DuckDB and MotherDuck are done through writing SQL qu
 ## Getting Started
-### Prerequisites
+### General Prerequisites
-- A MotherDuck account (sign up at [motherduck.com](https://motherduck.com))
-- A MotherDuck access token
 - `uv` installed, you can install it using `pip install uv` or `brew install uv`
-If you plan to use MotherDuck MCP with Claude Desktop, you will also need Claude Desktop installed.
+If you plan to use the MCP with Claude Desktop or any other MCP comptabile client, the client need to be installed.
+### Prerequisites for DuckDB
+- No prerequisites. The MCP server can create an in-memory database on-the-fly
+- Or connect to an existing local DuckDB database file , or one stored on remote object storage (e.g., AWS S3).
+See [Connect to local DuckDB](#connect-to-local-duckdb).
+### Prerequisites for MotherDuck
+- Sign up for a [MotherDuck account](https://app.motherduck.com/?auth_flow=signup)
+- Generate an access token via the [MotherDuck UI](https://app.motherduck.com/settings/tokens?auth_flow=signup)
+- Store the token securely for use in the configuration
+### Usage with Cursor
+1. Install Cursor from [cursor.com/downloads](https://www.cursor.com/downloads) if you haven't already
-### Setting up your MotherDuck token
+2. Open Cursor:
-1. Sign up for a [MotherDuck account](https://app.motherduck.com/?auth_flow=signup)
-2. Generate an access token via the [MotherDuck UI](https://app.motherduck.com/settings/tokens?auth_flow=signup)
-3. Store the token securely for use in the configuration
+- To set it up globally for the first time, go to Settings->MCP and click on "+ Add new global MCP server".
+- This will open a `mcp.json` file to which you add the following configuration:
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "md:",
+        "--motherduck-token",
+        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
+      ]
+    }
+  }
+}
+```
 ### Usage with VS Code
 [![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=mcp-server-motherduck&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-motherduck%22%2C%22--db-path%22%2C%22md%3A%22%2C%22--motherduck-token%22%2C%22%24%7Binput%3Amotherduck_token%7D%22%5D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22motherduck_token%22%2C%22description%22%3A%22MotherDuck+Token%22%2C%22password%22%3Atrue%7D%5D) [![Install with UV in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-UV-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=mcp-server-motherduck&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-motherduck%22%2C%22--db-path%22%2C%22md%3A%22%2C%22--motherduck-token%22%2C%22%24%7Binput%3Amotherduck_token%7D%22%5D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22motherduck_token%22%2C%22description%22%3A%22MotherDuck+Token%22%2C%22password%22%3Atrue%7D%5D&quality=insiders)
 1. For the quickest installation, click one of the "Install with UV" buttons at the top of this README.
 ### Manual Installation
@@ -127,7 +163,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
         "md:",
         "--motherduck-token",
         "<YOUR_MOTHERDUCK_TOKEN_HERE>"
-      ],
+      ]
     }
   }
 }
@@ -139,9 +175,102 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
 - Replace `YOUR_HOME_FOLDER_PATH` with the path to your home directory (needed by DuckDB for file operations). For example, on macOS, it would be `/Users/your_username`
 - The `HOME` environment variable is required for DuckDB to function properly.
+## Securing your MCP Server when querying MotherDuck
+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.
+**Read Scaling Tokens** are special access tokens that enable scalable read operations by allowing up to 4 concurrent read replicas, improving performance for multiple end users while *restricting write capabilities*.
+Refer to the [Read Scaling documentation](https://motherduck.com/docs/key-tasks/authenticating-and-connecting-to-motherduck/read-scaling/#creating-a-read-scaling-token) to learn how to create a read-scaling token.
+**SaaS Mode** in MotherDuck enhances security by restricting it's access to local files, databases, extensions, and configurations, making it ideal for third-party tools that require stricter environment protection. Learn more about it in the [SaaS Mode documentation](https://motherduck.com/docs/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck/#authentication-using-saas-mode).
+**Secure Configuration**
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "md:",
+        "--motherduck-token",
+        "<YOUR_READ_SCALING_TOKEN_HERE>",
+        "--saas-mode"
+      ]
+    }
+  }
+}
+```
+## Connect to local DuckDB
+To connect to a local DuckDB, instead of using the MotherDuck token, specify the path to your local DuckDB database file or use `:memory:` for an in-memory database.
+In-memory database:
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        ":memory:"
+      ]
+    }
+  }
+}
+```
+Local DuckDB file:
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "/path/to/your/local.db"
+      ]
+    }
+  }
+}
+```
+Local DuckDB file in [readonly mode](https://duckdb.org/docs/stable/connect/concurrency.html):
+```json
+{
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-motherduck",
+        "--db-path",
+        "/path/to/your/local.db",
+        "--read-only"
+      ]
+    }
+  }
+}
+```
+**Note**: readonly mode for local file-backed DuckDB connections also makes use of
+short lived connections. Each time the query MCP tool is used a temporary,
+reaodnly connection is created + query is executed + connection is closed. This
+feature was motivated by a workflow where [DBT](https://www.getdbt.com) was for
+modeling data within duckdb and then an MCP client (Windsurf/Cline/Claude/Cursor)
+was used for exploring the database. The short lived connections allow each tool
+to run and then release their connection, allowing the next tool to connect.
 ## Example Queries
-Once configured, you can ask Claude to run queries like:
+Once configured, you can e.g. ask Claude to run queries like:
 - "Create a new database and table in MotherDuck"
 - "Query data from my local CSV file"
@@ -182,7 +311,7 @@ If you don't specify a database path but have set the `motherduck_token` environ
 ## Running in SSE mode
-The server could also be run ing SSE mode using `supergateway` by running the following command:
+The server could also be running SSE mode using `supergateway` by running the following command:
 ```bash
 npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>"
@@ -190,6 +319,30 @@ npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduc
 And you can point your clients such as Claude Desktop, Cursor to this endpoint.
+## Development configuration
+To run the server from a local development environment, use the following configuration:
+```json
+ {
+  "mcpServers": {
+    "mcp-server-motherduck": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/path/to/your/local/mcp-server-motherduck",
+        "run",
+        "mcp-server-motherduck",
+        "--db-path",
+        "md:",
+        "--motherduck-token",
+        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
+      ]
+    }
+  }
+}
+```
 ## Troubleshooting
 - If you encounter connection issues, verify your MotherDuck token is correct

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/pyproject.toml RENAMED Viewed

@@ -1,12 +1,12 @@
 [project]
 name = "mcp-server-motherduck"
-version = "0.4.1"
+version = "0.4.3"
 description = "A MCP server for MotherDuck and local DuckDB"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
  "mcp>=1.3.0",
- "duckdb==1.2.1",
+ "duckdb==1.2.2",
  "pandas>=2.0.0",
  "tabulate>=0.9.0",
 ]

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/src/mcp_server_motherduck/__init__.py RENAMED Viewed

@@ -26,6 +26,11 @@ def main():
         default=None,
         help="(Default: env var `HOME`) Home directory for DuckDB",
     )
+    parser.add_argument(
+        "--saas-mode",
+        action="store_true",
+        help="Flag for connecting to MotherDuck in SaaS mode",
+    )
     # This is experimental and will change in the future
     parser.add_argument(
         "--result-format",
@@ -34,6 +39,12 @@ def main():
         choices=["markdown", "duckbox", "text"],
     )
+    parser.add_argument(
+        "--read-only",
+        action="store_true",
+        help="Flag for connecting to DuckDB in read-only mode. Only supported for local DuckDB databases. Also makes use of short lived connections so multiple MCP clients or other systems can remain active (though each operation must be done sequentially).",
+    )
     args = parser.parse_args()
     logger.info("🦆 MotherDuck MCP Server v" + server.SERVER_VERSION)
     logger.info("Ready to execute SQL queries via DuckDB/MotherDuck")
@@ -45,6 +56,8 @@ def main():
             motherduck_token=args.motherduck_token,
             result_format=args.result_format,
             home_dir=args.home_dir,
+            saas_mode=args.saas_mode,
+            read_only=args.read_only,
         )
     )

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/src/mcp_server_motherduck/server.py RENAMED Viewed

@@ -2,7 +2,7 @@ import os
 import logging
 import duckdb
 from pydantic import AnyUrl
-from typing import Literal
+from typing import Literal, Optional
 import io
 from contextlib import redirect_stdout
 import mcp.server.stdio
@@ -12,7 +12,7 @@ from mcp.server.models import InitializationOptions
 from .prompt import PROMPT_TEMPLATE
-SERVER_VERSION = "0.4.1"
+SERVER_VERSION = "0.4.3"
 logger = logging.getLogger("mcp_server_motherduck")
@@ -24,9 +24,12 @@ class DatabaseClient:
         motherduck_token: str | None = None,
         result_format: Literal["markdown", "duckbox", "text"] = "markdown",
         home_dir: str | None = None,
+        saas_mode: bool = False,
+        read_only: bool = False,
     ):
+        self._read_only = read_only
         self.db_path, self.db_type = self._resolve_db_path_type(
-            db_path, motherduck_token
+            db_path, motherduck_token, saas_mode
         )
         logger.info(f"Database client initialized in `{self.db_type}` mode")
@@ -37,11 +40,32 @@ class DatabaseClient:
         self.conn = self._initialize_connection()
         self.result_format = result_format
-    def _initialize_connection(self) -> duckdb.DuckDBPyConnection:
+    def _initialize_connection(self) -> Optional[duckdb.DuckDBPyConnection]:
         """Initialize connection to the MotherDuck or DuckDB database"""
         logger.info(f"🔌 Connecting to {self.db_type} database")
+        if self.db_type == "duckdb" and self._read_only:
+            # check that we can connect, issue a `select 1` and then close + return None
+            try:
+                conn = duckdb.connect(
+                    self.db_path,
+                    config={
+                        "custom_user_agent": f"mcp-server-motherduck/{SERVER_VERSION}"
+                    },
+                    read_only=self._read_only,
+                )
+                conn.execute("SELECT 1")
+                conn.close()
+                return None
+            except Exception as e:
+                logger.error(f"❌ Read-only check failed: {e}")
+                raise
+        if self._read_only:
+            raise ValueError(
+                "Read-only mode is only supported for local DuckDB databases. See `saas_mode` for similar functionality with MotherDuck."
+            )
         conn = duckdb.connect(
             self.db_path,
             config={"custom_user_agent": f"mcp-server-motherduck/{SERVER_VERSION}"},
@@ -52,14 +76,24 @@ class DatabaseClient:
         return conn
     def _resolve_db_path_type(
-        self, db_path: str, motherduck_token: str | None = None
+        self, db_path: str, motherduck_token: str | None = None, saas_mode: bool = False
     ) -> tuple[str, Literal["duckdb", "motherduck"]]:
         """Resolve and validate the database path"""
         # Handle MotherDuck paths
         if db_path.startswith("md:"):
             if motherduck_token:
                 logger.info("Using MotherDuck token to connect to database `md:`")
-                return f"{db_path}?motherduck_token={motherduck_token}", "motherduck"
+                if saas_mode:
+                    logger.info("Connecting to MotherDuck in SaaS mode")
+                    return (
+                        f"{db_path}?motherduck_token={motherduck_token}&saas_mode=true",
+                        "motherduck",
+                    )
+                else:
+                    return (
+                        f"{db_path}?motherduck_token={motherduck_token}",
+                        "motherduck",
+                    )
             elif os.getenv("motherduck_token"):
                 logger.info(
                     "Using MotherDuck token from env to connect to database `md:`"
@@ -83,25 +117,37 @@ class DatabaseClient:
             )
         return db_path, "duckdb"
+    def _execute(self, query: str) -> str:
+        if self.conn is None:
+            # open short lived readonly connection, run query, close connection, return result
+            conn = duckdb.connect(
+                self.db_path,
+                config={"custom_user_agent": f"mcp-server-motherduck/{SERVER_VERSION}"},
+                read_only=self._read_only,
+            )
+            q = conn.execute(query)
+        else:
+            q = self.conn.execute(query)
+        if self.result_format == "markdown":
+            out = q.fetchdf().to_markdown()
+        elif self.result_format == "duckbox":
+            # Duckbox version of the output
+            buffer = io.StringIO()
+            with redirect_stdout(buffer):
+                q.show(max_rows=100, max_col_width=20)
+            out = buffer.getvalue()
+        else:
+            out = str(q.fetchall())
+        if self.conn is None:
+            conn.close()
+        return out
     def query(self, query: str) -> str:
         try:
-            if self.result_format == "markdown":
-                # Markdown version of the output
-                logger.info(
-                    f"🔍 Executing query: {query[:60]}{'...' if len(query) > 60 else ''}"
-                )
-                result = self.conn.execute(query).fetchdf().to_markdown()
-                logger.info("✅ Query executed successfully")
-                return result
-            elif self.result_format == "duckbox":
-                # Duckbox version of the output
-                buffer = io.StringIO()
-                with redirect_stdout(buffer):
-                    self.conn.sql(query).show(max_rows=100, max_col_width=20)
-                return buffer.getvalue()
-            else:
-                # Text version of the output
-                return str(self.conn.execute(query).fetchall())
+            return self._execute(query)
         except Exception as e:
             raise ValueError(f"❌ Error executing query: {e}")
@@ -112,6 +158,8 @@ async def main(
     motherduck_token: str | None = None,
     result_format: Literal["markdown", "duckbox", "text"] = "markdown",
     home_dir: str | None = None,
+    saas_mode: bool = False,
+    read_only: bool = False,
 ):
     logger.info("Starting MotherDuck MCP Server")
     server = Server("mcp-server-motherduck")
@@ -120,6 +168,8 @@ async def main(
         result_format=result_format,
         motherduck_token=motherduck_token,
         home_dir=home_dir,
+        saas_mode=saas_mode,
+        read_only=read_only,
     )
     logger.info("Registering handlers")

{mcp_server_motherduck-0.4.1 → mcp_server_motherduck-0.4.3}/uv.lock RENAMED Viewed

@@ -62,42 +62,42 @@ wheels = [
 [[package]]
 name = "duckdb"
-version = "1.2.1"
+version = "1.2.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/41/b4/34b98425d643e412f52703829b5ed2da7d7cb6dd40c80a3aa210002cafa8/duckdb-1.2.1.tar.gz", hash = "sha256:15d49030d04572540cc1c8ad8a491ce018a590ec995d5d38c8f5f75b6422413e", size = 11591514 }
+sdist = { url = "https://files.pythonhosted.org/packages/28/b8/0f86278684fb7a1fac7c0c869fc6d68ed005cdc91c963eb4373e0551bc0a/duckdb-1.2.2.tar.gz", hash = "sha256:1e53555dece49201df08645dbfa4510c86440339889667702f936b7d28d39e43", size = 11595514 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/88/38/3b4fc59d585d6f0dfd86ebd7eaabecddf237717dfd2bc45e0b8d29d97a4b/duckdb-1.2.1-cp310-cp310-macosx_12_0_arm64.whl", hash = "sha256:b1b26271c22d1265379949b71b1d13a413f8048ea49ed04b3a33f257c384fa7c", size = 15250747 },
-    { url = "https://files.pythonhosted.org/packages/2a/48/00712205ab64a5c0af120fe0481822b89c99ad29559e46993339de3a20aa/duckdb-1.2.1-cp310-cp310-macosx_12_0_universal2.whl", hash = "sha256:47946714d3aa423782678d37bfface082a9c43d232c44c4b79d70a1137e4c356", size = 31914009 },
-    { url = "https://files.pythonhosted.org/packages/83/62/5b03ed3ad42b05eb47657e59b7d3c9b8912bd621c06f5303e2e98f1323d5/duckdb-1.2.1-cp310-cp310-macosx_12_0_x86_64.whl", hash = "sha256:2c3d3f069a114cfb4ebf5e35798953c93491cfb5866cfc57a4921f8b5d38cc05", size = 16771835 },
-    { url = "https://files.pythonhosted.org/packages/02/08/99e91459e1007e140a27a0d7cd09806db99b4a2cc59b8ab1f8ee8560a10d/duckdb-1.2.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:433406949970f4a8ab5416f62af224d418d3bbafe81585ede77057752c04017e", size = 18724706 },
-    { url = "https://files.pythonhosted.org/packages/6b/95/73681dfa03f05ed49ce0476e4b826ce079ea72d0779ebd51d79d51a0d86e/duckdb-1.2.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:42d156dacb1fd39b7293ee200d16af2cc9d08e57f7f7b5e800aa35bd265fc41f", size = 20191133 },
-    { url = "https://files.pythonhosted.org/packages/1e/a3/efa40117d0261c8c8d431c06016c80e8cb735d198d94e5a8c0ae4f9e95bd/duckdb-1.2.1-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e11ccbfd088dbac68dc35f4119fb385a878ca1cce720111c394f513d89a8b5f", size = 18733708 },
-    { url = "https://files.pythonhosted.org/packages/79/53/e3bbf938c5b99a8c95bf66505457bf3d6947951b3f98ebffa5bf5f1ba02a/duckdb-1.2.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:66322686a31a566b4c98f079513b1eba21a7de1d716b5b7d3a55aef8f97ee369", size = 22248683 },
-    { url = "https://files.pythonhosted.org/packages/63/79/ecd3cd85ed0859fc965bc0a2e3574627a8834c654db7f7155287de7f8f1d/duckdb-1.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:c1cbb84c65f8ef2fe32f4cbc8c7ed339c3ae6cf3e5814a314fa4b79a8ce9686a", size = 11362762 },
-    { url = "https://files.pythonhosted.org/packages/58/82/b119808dde71e42cc1fc77ac4a912e38c84eb47fa6ca4bc90652f99b7252/duckdb-1.2.1-cp311-cp311-macosx_12_0_arm64.whl", hash = "sha256:99c47ea82df549c284e4e4d8c89a940af4f19c03427f6f42cafeb3c152536bc5", size = 15252717 },
-    { url = "https://files.pythonhosted.org/packages/8a/ff/015fd0cdec48791c36d6251916b456e96ed9fb71a791a7385b26cec14810/duckdb-1.2.1-cp311-cp311-macosx_12_0_universal2.whl", hash = "sha256:203ebdf401d049135492cc3d49146cfd704d866ee9cc52b18e80a586aceabb69", size = 31915709 },
-    { url = "https://files.pythonhosted.org/packages/d7/d2/72ef2cf81562fdb6068b1e2cd19a878943067ce812060a4bc91e61d0e92d/duckdb-1.2.1-cp311-cp311-macosx_12_0_x86_64.whl", hash = "sha256:ac5f7c15176b6fb90f1f3bed08a99b9d32f55b58cd3d9d2ed6a1037a8fda2024", size = 16772294 },
-    { url = "https://files.pythonhosted.org/packages/b5/06/b454b94ceec3a813c5122a99b0259ced53874b15fb2dfdb669164dbcb153/duckdb-1.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:97b2c13f4f9290db60c783b93b79ce521a3890ff8d817a6670afb760e030043b", size = 18728528 },
-    { url = "https://files.pythonhosted.org/packages/50/52/6e6f5b5b07841cec334ca6b98f2e02b7bb54ab3b99c49aa3a161cc0b4b37/duckdb-1.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d493e051f594175a2a5bdcae5c008d3cc424805e3282292c1204f597880de8ea", size = 20197440 },
-    { url = "https://files.pythonhosted.org/packages/f5/dc/01c3f5a47d7433d1e261042f61e6b3d77634f28706975b3027697fa19de8/duckdb-1.2.1-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7c252be2ed07817916342823b271253459932c60d7f7ee4e28f33650552cda24", size = 18736032 },
-    { url = "https://files.pythonhosted.org/packages/1e/e4/7ef6b8e08c410fc13ba9f62ecf2802e8e2adcae38a5ea7a4f6829b99f32d/duckdb-1.2.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:832627f11b370d708543a86d18d5eda4eacb7ca51fdc83c74629adfff2ec1bf2", size = 22251245 },
-    { url = "https://files.pythonhosted.org/packages/a5/b7/e3f5d60117fe31623122a44b6d3e8f1cee9d87a23810c9c35bb1d743d4d2/duckdb-1.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:d05e5914857b4d93b136de385d81a65165a6c24a6ecf6eee3dcd0017233bff6c", size = 11363523 },
-    { url = "https://files.pythonhosted.org/packages/5d/70/2c1240415afc176ac7019f0fd5add3310ba93c80885a55d7fecc194108e6/duckdb-1.2.1-cp312-cp312-macosx_12_0_arm64.whl", hash = "sha256:7e587410e05343ffaf9a21bacb6811aad253bd443ab4ff869fdaa645908f47a4", size = 15263653 },
-    { url = "https://files.pythonhosted.org/packages/2c/6e/83caef4d3b6e68da768ec564d5c9b982a84d9167ead0ad674b69810d7bb8/duckdb-1.2.1-cp312-cp312-macosx_12_0_universal2.whl", hash = "sha256:8cb84295cafbf2510326f4ae18d401fc2d45b6d4811c43f1b7451a69a0a74f5f", size = 31955476 },
-    { url = "https://files.pythonhosted.org/packages/35/fb/ee33f3417d4778ab183d47fe8569dc7906a1b95f69cfb10f15d5f88e8dcf/duckdb-1.2.1-cp312-cp312-macosx_12_0_x86_64.whl", hash = "sha256:1b6dfefadc455347a2c649d41ebd561b32574b4191508043c9ee81fa0da95485", size = 16798219 },
-    { url = "https://files.pythonhosted.org/packages/21/11/9cf670a88f39dd18854883c38b9374c745e47d69896bb8dbc9cc239a43d6/duckdb-1.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3d75d9fdf5865399f634d824c8d427c7666d1f2c640115178115459fa69b20b0", size = 18730807 },
-    { url = "https://files.pythonhosted.org/packages/d4/5f/7b511dcaa772f9ae20c7f3fe05dd88174729fbcb67e15b349b72a3855712/duckdb-1.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d4a05d182d1dec1ff4acb53a266b3b8024afcc1ed0d399f5784ff1607a4271e9", size = 20199069 },
-    { url = "https://files.pythonhosted.org/packages/9c/58/7942a1d7c84a045e1513acc7e753ac67f2f272601a2c21d71b4cb85967e7/duckdb-1.2.1-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:317af7385b4f1d0c90ca029a71ce3d4f9571549c162798d58a0b20ba0a11762e", size = 18753393 },
-    { url = "https://files.pythonhosted.org/packages/6b/00/57417ae7d9bd47c71284bff7f69736bdde0f213ce312292e4f553449a667/duckdb-1.2.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41fca1666d0905e929ede0899a4275d67835a285b98e28fce446e8c3e53cfe8c", size = 22290931 },
-    { url = "https://files.pythonhosted.org/packages/71/bc/acb4d48f41dada36e723e9786d1ebe89f8e1db6685b86a2a1f0551bd5e16/duckdb-1.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:f8f19f145442dbdfae029b68208fc237816f70b3d25bb77ed31ace79b6059fa5", size = 11365235 },
-    { url = "https://files.pythonhosted.org/packages/e3/3b/d154fcde6205aafd2002ddec7eef37e5c7907c3aa63b51f6d9f7d2ec1442/duckdb-1.2.1-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:bc9ed3adea35e7e688750e80330b5b93cd430483d68a5f880dac76bedca14c0e", size = 15264713 },
-    { url = "https://files.pythonhosted.org/packages/20/3f/e54f898c62a3d6873c090f06bab62544ac33826ec65e7598af7c09264a14/duckdb-1.2.1-cp313-cp313-macosx_12_0_universal2.whl", hash = "sha256:b26ff415d89860b7013d711fce916f919ad058dbf0a3fc4bcdff5323ec4bbfa0", size = 31955551 },
-    { url = "https://files.pythonhosted.org/packages/11/b9/19ecfcc13b402686cf6f121cb08451f7655bd653990fdabfda1f2db87081/duckdb-1.2.1-cp313-cp313-macosx_12_0_x86_64.whl", hash = "sha256:0e26037b138a22f72fe44697b605ccac06e223c108b3f4a3e91e7ffad45ee673", size = 16797823 },
-    { url = "https://files.pythonhosted.org/packages/35/69/20fe0c748371866bdd150d60b065498b7414537c4ad0f7235b5ae604ac99/duckdb-1.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e2f530e8290e4b2d2c341bc709a6a0c9ec7a0e1c7a4679afa7bd4db972fcf12", size = 18731358 },
-    { url = "https://files.pythonhosted.org/packages/cc/f7/ba9b39791a0415c48d4696f10217e44ac526e450b811bc68f9acf0ef3b5c/duckdb-1.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7985129c4bc810cb08938043822bb1fc4b67c11f4c1b025527f9c888e0638b6a", size = 20198769 },
-    { url = "https://files.pythonhosted.org/packages/9c/6c/07717799b64e34dd383c4fe9a3a53f5506c97ada096b103154c8856dc68b/duckdb-1.2.1-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:be76e55e9a36febcb0c7c7c28b8fae0b33bbcf6a84b3b23eb23e7ee3e65e3394", size = 18754621 },
-    { url = "https://files.pythonhosted.org/packages/53/8b/f971b0cd6cfc3ac094d31998b789a8fb372bd0813fbb47c932342fc926f0/duckdb-1.2.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:d8f5066ae9acc6cee22c7a455696511d993bdbfc55bb9466360b073b5c8cba67", size = 22291214 },
-    { url = "https://files.pythonhosted.org/packages/1e/1c/4e29e52a35b5af451b24232b6f89714180da71c904017e62f7cc5477f135/duckdb-1.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6112711457b6014ac041492bedf8b6a97403666aefa20a4a4f3479db10136501", size = 11365219 },
+    { url = "https://files.pythonhosted.org/packages/cc/47/d17eecc8bf23519f4385a7ad361482e5791f6b94995a50839f130c469626/duckdb-1.2.2-cp310-cp310-macosx_12_0_arm64.whl", hash = "sha256:6e5e6c333b550903ff11919ed1154c60c9b9d935db51afdb263babe523a8a69e", size = 15255351 },
+    { url = "https://files.pythonhosted.org/packages/bd/d1/317397198e0481339c469441762ce4e563f612479c2be70ddba3c1493bf2/duckdb-1.2.2-cp310-cp310-macosx_12_0_universal2.whl", hash = "sha256:c1fcbc579de8e4fa7e34242fd6f419c1a39520073b1fe0c29ed6e60ed5553f38", size = 31925074 },
+    { url = "https://files.pythonhosted.org/packages/3d/e2/9f8cfa9d8a8d1370ae2b5cf0c6a34e6adc51be533771fd75b5ff84fb2441/duckdb-1.2.2-cp310-cp310-macosx_12_0_x86_64.whl", hash = "sha256:690885060c4140922ffa2f6935291c6e74ddad0ca2cf33bff66474ce89312ab3", size = 16779904 },
+    { url = "https://files.pythonhosted.org/packages/e6/47/3651b1ab62b6e8ce15a1ead5d81d4bc76b09912c2ae0b11aa0bbcbd0209d/duckdb-1.2.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8a382782980643f5ee827990b76f079b22f47786509061c0afac28afaa5b8bf5", size = 18726556 },
+    { url = "https://files.pythonhosted.org/packages/6d/66/6b2a433d042a3a5109c1a62a4daaea40b908e7876756aed2837adaf0ca26/duckdb-1.2.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d7c33345570ed8c50c9fe340c2767470115cc02d330f25384104cfad1f6e54f5", size = 20195269 },
+    { url = "https://files.pythonhosted.org/packages/a3/38/1737151fba968c0e7221b68d11c80ed9ff63edf380d91058426b51f1b233/duckdb-1.2.2-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b744f8293ce649d802a9eabbf88e4930d672cf9de7d4fc9af5d14ceaeeec5805", size = 18737528 },
+    { url = "https://files.pythonhosted.org/packages/b3/37/bfde2ea14353a297e7effe9e4688b4e60a3ec08a9bd67c404c64046e5d9e/duckdb-1.2.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:c8680e81b0c77be9fc968c1dd4cd38395c34b18bb693cbfc7b7742c18221cc9b", size = 22254571 },
+    { url = "https://files.pythonhosted.org/packages/f0/42/392736bfd62b5b5f0d9ea15b010c90a8c92c21fdfc4372e46160f3d8f680/duckdb-1.2.2-cp310-cp310-win_amd64.whl", hash = "sha256:fb41f2035a70378b3021f724bb08b047ca4aa475850a3744c442570054af3c52", size = 11366201 },
+    { url = "https://files.pythonhosted.org/packages/c1/41/78c63937a4f7a5de7d128203c567303d4813c1109b7d17e6b3959f0882e1/duckdb-1.2.2-cp311-cp311-macosx_12_0_arm64.whl", hash = "sha256:081110ffbc9d53c9740ef55482c93b97db2f8030d681d1658827d2e94f77da03", size = 15258298 },
+    { url = "https://files.pythonhosted.org/packages/94/b2/91d983ecd67a1b87343e98395ffe7d77c996e1798c1bab339beed4680693/duckdb-1.2.2-cp311-cp311-macosx_12_0_universal2.whl", hash = "sha256:53a154dbc074604036a537784ce5d1468edf263745a4363ca06fdb922f0d0a99", size = 31933969 },
+    { url = "https://files.pythonhosted.org/packages/ad/12/4737b682cbc1b4778ffb37e4f4cdb603676c50aec89d6c9781ec29d3e904/duckdb-1.2.2-cp311-cp311-macosx_12_0_x86_64.whl", hash = "sha256:0353f80882c066f7b14451852395b7a360f3d4846a10555c4268eb49144ea11c", size = 16784775 },
+    { url = "https://files.pythonhosted.org/packages/71/be/dfb52b579a0b82aa92993aecc100bd951d0bd1850c6a8d47c68953a9de62/duckdb-1.2.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b134a5002757af1ae44a9ae26c2fe963ffa09eb47a62779ce0c5eeb44bfc2f28", size = 18731124 },
+    { url = "https://files.pythonhosted.org/packages/ca/49/153dd6289a3d06e87c3199a5547ccc04c574d167d7f85c1a8196218bf040/duckdb-1.2.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd9c434127fd1575694e1cf19a393bed301f5d6e80b4bcdae80caa368a61a678", size = 20199712 },
+    { url = "https://files.pythonhosted.org/packages/97/ce/f27a7b735a8abb04e2c1efcc05178e25e455539c74d70f76c2845bae8473/duckdb-1.2.2-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:890f58855d127c25bc3a53f4c24b27e79391c4468c4fcc99bc10d87b5d4bd1c4", size = 18739966 },
+    { url = "https://files.pythonhosted.org/packages/d8/f2/a8066267eb5fcd1f535776efde29b6d0fa678d978a7de73f47bc59cc940d/duckdb-1.2.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:9a5002305cdd4e76c94b61b50abc5e3f4e32c9cb81116960bb4b74acbbc9c6c8", size = 22255946 },
+    { url = "https://files.pythonhosted.org/packages/df/74/8a05ef00c554882d8300c2c261e8f7e7ead74e2b3ff66059599ff2646cf4/duckdb-1.2.2-cp311-cp311-win_amd64.whl", hash = "sha256:cdb9999c6a109aa31196cdd22fc58a810a3d35d08181a25d1bf963988e89f0a5", size = 11368173 },
+    { url = "https://files.pythonhosted.org/packages/77/25/549f68e55e1b455bd2daf2e5fc912000a3139fe0395111b3d49b23a2cec1/duckdb-1.2.2-cp312-cp312-macosx_12_0_arm64.whl", hash = "sha256:f745379f44ad302560688855baaed9739c03b37a331338eda6a4ac655e4eb42f", size = 15271882 },
+    { url = "https://files.pythonhosted.org/packages/f6/84/13de7bf9056dcc7a346125d9a9f0f26f76c633db6b54052738f78f828538/duckdb-1.2.2-cp312-cp312-macosx_12_0_universal2.whl", hash = "sha256:087713fc5958cae5eb59097856b3deaae0def021660c8f2052ec83fa8345174a", size = 31964873 },
+    { url = "https://files.pythonhosted.org/packages/0f/53/c8d2d56a801b7843ea87f8533a3634e6b38f06910098a266f8a096bd4c61/duckdb-1.2.2-cp312-cp312-macosx_12_0_x86_64.whl", hash = "sha256:a1f96395319c447a31b9477881bd84b4cb8323d6f86f21ceaef355d22dd90623", size = 16800653 },
+    { url = "https://files.pythonhosted.org/packages/bb/36/e25791d879fb93b92a56bf481ce11949ab19109103ae2ba12d64e49355d9/duckdb-1.2.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6aba3bc0acf4f8d52b94f7746c3b0007b78b517676d482dc516d63f48f967baf", size = 18735524 },
+    { url = "https://files.pythonhosted.org/packages/d7/46/4745aa10a1e460f4c8b473eddaffe2c783ac5280e1e5929dd84bd1a1acde/duckdb-1.2.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e5c1556775a9ebaa49b5c8d64718f155ac3e05b34a49e9c99443cf105e8b0371", size = 20210314 },
+    { url = "https://files.pythonhosted.org/packages/ff/0d/8563fc5ece36252e3d07dd3d29c7a0a034dcf62f14bed7cdc016d95adcbe/duckdb-1.2.2-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d625cc7d2faacfb2fc83ebbe001ae75dda175b3d8dce6a51a71c199ffac3627a", size = 18755134 },
+    { url = "https://files.pythonhosted.org/packages/11/f1/b7ade7d980eee4fb3ad7469ccf23adb3668a9a28cf3989b24418392d3786/duckdb-1.2.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:73263f81545c5cb4360fbaf7b22a493e55ddf88fadbe639c43efb7bc8d7554c4", size = 22294397 },
+    { url = "https://files.pythonhosted.org/packages/eb/c9/896e8ced7b408df81e015fe0c6497cda46c92d9dfc8bf84b6d13f5dad473/duckdb-1.2.2-cp312-cp312-win_amd64.whl", hash = "sha256:b1c0c4d737fd2ab9681e4e78b9f361e0a827916a730e84fa91e76dca451b14d5", size = 11370381 },
+    { url = "https://files.pythonhosted.org/packages/41/31/5e2f68cbd000137f6ed52092ad83a8e9c09eca70c59e0b4c5eb679709997/duckdb-1.2.2-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:fb9a2c77236fae079185a990434cb9d8432902488ba990235c702fc2692d2dcd", size = 15272507 },
+    { url = "https://files.pythonhosted.org/packages/d2/15/aa9078fc897e744e077c0c1510e34db4c809de1d51ddb5cb62e1f9c61312/duckdb-1.2.2-cp313-cp313-macosx_12_0_universal2.whl", hash = "sha256:d8bb89e580cb9a3aaf42e4555bf265d3db9446abfb118e32150e1a5dfa4b5b15", size = 31965548 },
+    { url = "https://files.pythonhosted.org/packages/9f/28/943773d44fd97055c59b58dde9182733661c2b6e3b3549f15dc26b2e139e/duckdb-1.2.2-cp313-cp313-macosx_12_0_x86_64.whl", hash = "sha256:88916d7f0532dc926bed84b50408c00dcbe6d2097d0de93c3ff647d8d57b4f83", size = 16800600 },
+    { url = "https://files.pythonhosted.org/packages/39/51/2caf01e7791e490290798c8c155d4d702ed61d69e815915b42e72b3e7473/duckdb-1.2.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:30bece4f58a6c7bb0944a02dd1dc6de435a9daf8668fa31a9fe3a9923b20bd65", size = 18735886 },
+    { url = "https://files.pythonhosted.org/packages/87/0c/48ae1d485725af3a452303af409a9022d751ecab260cb9ca2f8c9fb670bc/duckdb-1.2.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2bd2c6373b8b54474724c2119f6939c4568c428e1d0be5bcb1f4e3d7f1b7c8bb", size = 20210481 },
+    { url = "https://files.pythonhosted.org/packages/69/c7/95fcd7bde0f754ea6700208d36b845379cbd2b28779c0eff4dd4a7396369/duckdb-1.2.2-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:72f688a8b0df7030c5a28ca6072817c1f090979e08d28ee5912dee37c26a7d0c", size = 18756619 },
+    { url = "https://files.pythonhosted.org/packages/ad/1b/c9eab9e84d4a70dd5f7e2a93dd6e9d7b4d868d3df755cd58b572d82d6c5d/duckdb-1.2.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:26e9c349f56f7c99341b5c79bbaff5ba12a5414af0261e79bf1a6a2693f152f6", size = 22294667 },
+    { url = "https://files.pythonhosted.org/packages/3f/3d/ce68db53084746a4a62695a4cb064e44ce04123f8582bb3afbf6ee944e16/duckdb-1.2.2-cp313-cp313-win_amd64.whl", hash = "sha256:e1aec7102670e59d83512cf47d32a6c77a79df9df0294c5e4d16b6259851e2e9", size = 11370206 },
 ]
 [[package]]
@@ -185,7 +185,7 @@ wheels = [
 [[package]]
 name = "mcp-server-motherduck"
-version = "0.4.1"
+version = "0.4.3"
 source = { editable = "." }
 dependencies = [
     { name = "duckdb" },
@@ -196,7 +196,7 @@ dependencies = [
 [package.metadata]
 requires-dist = [
-    { name = "duckdb", specifier = "==1.2.1" },
+    { name = "duckdb", specifier = "==1.2.2" },
     { name = "mcp", specifier = ">=1.3.0" },
     { name = "pandas", specifier = ">=2.0.0" },
     { name = "tabulate", specifier = ">=0.9.0" },