Ktanaka101 MCP Server Duckdb

一个基于DuckDB的MCP服务器实现，提供通过MCP工具进行数据库交互的能力，支持查询、表创建和模式检查等操作，并可配置为只读模式确保数据安全。

数据库开发者工具 #数据库交互 #本地分析 #只读模式 #MCP协议 .Python

评分 : 2分

下载量 : 8.9K

更新时间 : 2025-04-29

打开站点

什么是DuckDB MCP Server?

这是一个能让您通过自然语言与DuckDB数据库交互的服务。它作为中间层，将您的请求转换为数据库操作，特别适合不熟悉SQL的用户进行本地数据分析。

如何使用DuckDB MCP Server?

您可以通过Claude Desktop或直接安装来使用该服务。安装后，配置数据库路径即可开始查询和分析数据。

适用场景

适合需要快速分析本地数据的场景，如CSV文件分析、小型数据集处理、原型开发等。特别适合数据科学家和开发者进行探索性数据分析。

主要功能

数据查询

执行SELECT查询从数据库中读取数据，支持各种条件筛选和聚合操作

数据修改

执行INSERT、UPDATE或DELETE操作修改数据库内容(可禁用)

表管理

创建新表并定义表结构，方便组织数据

结构查看

查看数据库中有哪些表以及表的结构信息

优势

轻量级: DuckDB是专为分析型工作负载设计的嵌入式数据库，占用资源少

易用性: 通过自然语言即可操作数据库，无需精通SQL

安全性: 提供只读模式，防止意外修改数据

本地运行: 数据完全在本地处理，无需网络连接

局限性

不适合大规模生产环境: 主要用于本地分析和开发

功能有限: 相比完整的关系数据库，功能有所简化

并发限制: DuckDB在写入操作时的并发能力有限

如何使用

安装服务

通过Smithery自动安装或手动配置

配置数据库路径

在Claude Desktop配置文件中指定DuckDB数据库文件位置

开始使用

在Claude中直接输入自然语言指令与数据库交互

使用案例

销售数据分析

分析月度销售数据，找出最畅销产品和销售趋势

用户数据管理

创建新表存储用户信息并查询特定用户

数据探索

快速查看数据库中有哪些表和它们的结构

常见问题

数据库文件不存在会怎样？

如何确保数据安全？

支持哪些SQL操作？

数据库大小有限制吗？

🚀 mcp-server-duckdb

这是一个针对DuckDB的模型上下文协议（MCP）服务器实现，它提供了通过MCP工具与数据库进行交互的能力。DuckDB非常适合用于本地分析，使用该服务器可以方便地对DuckDB数据库进行各种操作。

🚀 快速开始

此服务器通过模型上下文协议（MCP）实现与DuckDB数据库的交互，支持执行查询、创建表以及查看表结构等操作。

✨ 主要特性

支持通过MCP工具与DuckDB数据库进行交互。
提供多种数据库交互工具，如执行查询、创建表、列出表等。
支持以只读模式运行，确保数据完整性。

📦 安装指南

使用Smithery安装：

# 示例命令

在Claude Desktop中配置：

将以下内容添加到配置文件中：

# 示例路径设置

📚 详细文档

组件

资源

目前没有自定义资源实现。

提示语

目前没有自定义提示语实现。

工具

服务器实现了以下数据库交互工具：

工具名称	功能	输入	输出
read-query	执行SELECT查询以读取数据	`query`（字符串）- 必须是SELECT语句	查询结果文本
write-query	执行INSERT、UPDATE或DELETE查询以修改数据	`query`（字符串）- 必须是非SELECT语句	查询结果文本
create-table	创建新表	`query`（字符串）- 必须是CREATE TABLE语句	成功确认消息
list-tables	列出数据库中的所有表	无	从`information_schema`获取的表列表
describe-table	获取特定表格的架构信息	`table_name`（字符串）- 要描述的表格名称	表格架构信息

⚠️ 重要提示

当服务器以只读模式运行时，write-query和create-table工具将被禁用以防止任何写入操作，这确保了语言模型（LLM）无法执行任何数据库修改操作，从而保持数据完整性并防止意外更改。

配置

必要参数

属性	详情
db-path（字符串）	DuckDB数据库文件路径，服务器会自动创建数据库文件及其父目录（如果它们不存在）

可选参数

属性	详情
--readonly	以只读模式运行服务器。当此标志设置时，DuckDB数据库将使用`read_only=True`打开，防止任何写入操作；如果指定的数据库文件不存在，则不会创建它；具有阻止语言模型（LLM）执行任何写入操作，确保数据库保持不变的安全性优势。注意：`read_only`在DuckDB中是正确的术语。