Ktanaka101 MCP Server Duckdb

DuckDBに基づくMCPサーバーの実装で、MCPツールを通じてデータベースとのやり取りを可能にし、クエリ、テーブル作成、スキーマチェックなどの操作をサポートし、読み取り専用モードに設定してデータの安全性を確保できます。

データベース開発者ツール #データベースやり取り #ローカル分析 #読み取り専用モード #MCPプロトコル .Python

スコア : 2ポイント

ダウンロード数 : 9.1K

更新時間 : 2025-04-29

サイトを開く

DuckDB MCPサーバーとは？

これは、自然言語でDuckDBデータベースとやり取りできるサービスです。中間層として機能し、あなたのリクエストをデータベース操作に変換します。特にSQLに不慣れなユーザーがローカルのデータ分析を行うのに適しています。

DuckDB MCPサーバーの使い方は？

Claude Desktopを通じて、または直接インストールしてこのサービスを使用できます。インストール後、データベースのパスを設定すると、データのクエリと分析を開始できます。

適用シーン

CSVファイルの分析、小規模データセットの処理、プロトタイプ開発など、ローカルデータを迅速に分析する必要があるシーンに適しています。特にデータサイエンティストや開発者が探索的なデータ分析を行うのに最適です。

主要機能

データクエリ

SELECTクエリを実行してデータベースからデータを読み取り、さまざまな条件フィルタリングと集約操作をサポートします。

データ修正

INSERT、UPDATE、またはDELETE操作を実行してデータベースの内容を修正します（無効にすることもできます）。

テーブル管理

新しいテーブルを作成し、テーブル構造を定義して、データを整理しやすくします。

構造確認

データベースにどのようなテーブルがあり、そのテーブルの構造情報を確認します。

利点

軽量: DuckDBは分析型ワークロード用に設計された組み込みデータベースで、リソースの消費が少ない

使いやすさ: 自然言語でデータベースを操作でき、SQLを熟知する必要がない

安全性: 読み取り専用モードを提供し、データの誤った修正を防止する

ローカル実行: データは完全にローカルで処理され、ネットワーク接続が不要

制限

大規模な本番環境には適さない: 主にローカル分析と開発に使用される

機能が制限されている: 完全なリレーショナルデータベースと比較して、機能が簡略化されている

同時実行制限: DuckDBは書き込み操作時の同時実行能力が限られている

使い方

サービスのインストール

Smitheryを通じて自動インストールするか、手動で設定します。

データベースパスの設定

Claude Desktopの設定ファイルでDuckDBデータベースファイルの場所を指定します。

使用開始

Claudeで自然言語の命令を直接入力してデータベースとやり取りします。

使用例

販売データ分析

月次の販売データを分析し、最も売れた商品と販売傾向を見つけます。

ユーザーデータ管理

ユーザー情報を保存する新しいテーブルを作成し、特定のユーザーをクエリします。

データ探索

データベースにどのようなテーブルがあり、その構造をすばやく確認します。

よくある質問

データベースファイルが存在しない場合、どうなりますか？

データの安全性を確保するにはどうすればいいですか？

どのようなSQL操作がサポートされていますか？

データベースのサイズに制限はありますか？

🚀 mcp-server-duckdb

DuckDBに対応したモデルコンテキストプロトコル（MCP）サーバーの実装で、MCPツールを通じたデータベースとのやり取りが可能です。DuckDBはローカル分析に最適です。

🚀 クイックスタート

このサーバーは、モデルコンテキストプロトコル（MCP）を通じてDuckDBデータベースとのやり取りを実現し、クエリの実行、テーブルの作成、テーブル構造の確認などの操作をサポートしています。

✨ 主な機能

コンポーネント

リソース

現在、カスタムリソースの実装はありません。

プロンプト

現在、カスタムプロンプトの実装はありません。

ツール

サーバーは以下のデータベース操作ツールを実装しています。

ツール名	説明	入力	出力
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）がデータベースの変更操作を実行できないようにし、データの整合性を保ち、意図しない変更を防止します。

📦 インストール

Smitheryを使用したインストール

# サンプルコマンド

Claude Desktopでの設定

以下の内容を設定ファイルに追加します。

# サンプルのパス設定

📚 ドキュメント

設定

必須パラメータ

db - path（文字列）：DuckDBデータベースファイルのパス。
- サーバーは、データベースファイルとその親ディレクトリが存在しない場合、自動的に作成します。

オプションパラメータ

--readonly：サーバーを読み取り専用モードで実行します。
- 説明：このフラグが設定されると、サーバーは読み取り専用モードで実行されます。これは次のことを意味します。
  - DuckDBデータベースはread_only = Trueで開かれ、書き込み操作が防止されます。
  - 指定されたデータベースファイルが存在しない場合、作成されません。
  - セキュリティ上の利点：言語モデル（LLM）が書き込み操作を実行できないようにし、データベースを変更できないようにします。
- 注意：read_onlyはDuckDBで正しい用語です。