mcp-server-motherduck MCP server
2025.02.17
0
Python数据库管理数据查询数据库
mcp-server-motherduck 是一个基于 Model Context Protocol (MCP) 的服务器，主要用于与 MotherDuck 和本地 DuckDB 数据库进行交互。它提供了初始化连接、读取数据库表结构以及执行查询等功能，适用于需要高效管理和操作 DuckDB 或 MotherDuck 数据库的场景。
View on GitHub
Overview
基本能力
产品定位
mcp-server-motherduck 是一个数据库交互工具，专注于为 DuckDB 和 MotherDuck 提供高效的连接和操作能力。
核心功能
- 初始化连接：支持连接到本地 DuckDB 或 MotherDuck 数据库，并获取可用数据库列表。
- 读取表结构：从指定的数据库中获取表的模式（schema）。
- 执行查询：在 MotherDuck 或 DuckDB 数据库上执行 SQL 查询。
适用场景
- 需要快速连接和操作 DuckDB 或 MotherDuck 数据库的开发环境。
- 数据库管理和维护任务，如查询执行和表结构分析。
- 集成到 Claude Desktop 等工具中，提升数据库操作的自动化程度。
工具列表
- initialize-connection：初始化连接到 DuckDB 或 MotherDuck，并返回可用数据库列表。
- 输入参数：
type（DuckDB 或 MotherDuck）。 - read-schemas：获取指定数据库的表结构。
- 输入参数：
database_name（数据库名称）。 - execute-query：在数据库上执行 SQL 查询。
- 输入参数：
query（SQL 查询语句）。
常见问题解答
- 如何设置 MotherDuck 令牌？
- 需要将 MotherDuck 令牌设置为环境变量
motherduck_token。 - 如何配置 Claude Desktop 以使用此服务？
- 在 Claude Desktop 的配置文件中添加服务器配置，并设置
HOME环境变量。
使用教程
使用依赖
- 确保已安装 DuckDB 或 MotherDuck 并配置好环境。
- 设置
HOME环境变量（DuckDB 需要）。 - 如需使用 MotherDuck，设置
motherduck_token环境变量。
安装教程
- 通过以下命令安装服务：
bash uvx mcp-server-motherduck - 配置 Claude Desktop 的
claude_desktop_config.json文件，添加以下内容：json "mcpServers": { "mcp-server-motherduck": { "command": "uvx", "args": [ "mcp-server-motherduck" ], "env": { "motherduck_token": "", "HOME": "" } } }
调试方式
- 确保服务已正确安装并运行。
- 使用工具进行测试，例如：
- 初始化连接：
bash initialize-connection --type DuckDB - 读取表结构：
bash read-schemas --database_name mydb - 执行查询：
bash execute-query --query "SELECT * FROM mytable"