Ktanaka101 MCP Server Duckdb

一個基於DuckDB的MCP服務器實現，提供通過MCP工具進行數據庫交互的能力，支持查詢、表創建和模式檢查等操作，並可配置為只讀模式確保數據安全。

數據庫開發者工具 #數據庫交互 #本地分析 #只讀模式 #MCP協議 .Python

評分 : 2分

下載量 : 8.7K

更新時間 : 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中是正確的術語。