SQLite MCP Server

SQLite MCP サーバー

SQLite データベース向けの Model Context Protocol（MCP）サーバー実装です。標準化されたツールを通じて、AI モデルが SQLite データベースを操作できます。

機能

• クエリの実行：組み込みの検証と安全性チェックを備えた SQL クエリの実行
• スキーマの検出：テーブルの一覧表示とテーブルスキーマの説明
• 行数のカウント：指定したテーブルの行数をカウント
• サンプルデータ：デモ用のサンプルデータを挿入（読み取り専用モードでない場合）
• 自動初期化：データベースが存在しない場合、製品、顧客、注文、フィードバックを含むサンプルデータベースを作成
• 読み取り専用モード：安全のため、読み取り専用操作に制限するオプション
• フィードバックの収集：ユーザーのフィードバックを収集し、データベースに保存するツール

要件

• Python 3.8+
• requirements.txt に記載されている依存関係

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：

pip install -r requirements.txt

3. 環境変数を設定します（任意）：
   • .env.example を .env にコピーします（または既存の .env ファイルを使用します）
   • 必要に応じて設定を変更します

使用方法

サーバーの起動

python server.py

サーバーはポート 8080（または .env ファイルで指定されたポート）で起動します。

設定オプション

.env ファイルを編集してサーバーを設定します：

DB_PATH=sample.db         # Path to your SQLite database file
MCP_PORT=8080             # Port to run the MCP server on
READ_ONLY=true            # Set to false to allow write operations

Claude Desktop での使用

このサーバーを Claude Desktop の設定に追加します：

{
"mcpServers": {
		"sqlite": {
			"command": "<Path to UV>",
			"args": [
				"--directory",
				"<Absolute Path to Project Workspace>",
				"run",
				"server.py"
			]
		}
	}
}

利用可能なツール

MCP サーバーは次のツールを提供します：

1. execute_query - データベースで SQL クエリを実行します
2. list_tables - データベース内のすべてのテーブルを一覧表示します
3. describe_table - 特定のテーブルのスキーマを取得します
4. count_rows - 特定のテーブルの行数をカウントします
5. insert_sample_data - サンプルデータを挿入します（読み取り専用モードでは無効）
6. add_feedback - フィードバックテーブルにユーザーのフィードバックを追加します（読み取り専用モードでは無効）

サンプルデータベースのスキーマ

サンプルデータベースには、次のテーブルが含まれます：

製品テーブル

• id (INTEGER, PRIMARY KEY)
• name (TEXT, NOT NULL)
• description (TEXT)
• price (REAL, NOT NULL)
• category (TEXT)
• in_stock (BOOLEAN)

顧客テーブル

• id (INTEGER, PRIMARY KEY)
• name (TEXT, NOT NULL)
• email (TEXT, UNIQUE)
• signup_date (TEXT)

注文テーブル

• id (INTEGER, PRIMARY KEY)
• customer_id (INTEGER, FOREIGN KEY)
• order_date (TEXT)
• total_amount (REAL)

フィードバックテーブル

• id (INTEGER, PRIMARY KEY)
• user (TEXT, NOT NULL)
• email (TEXT, NOT NULL)
• feedback (TEXT, NOT NULL)
• submission_date (TEXT, DEFAULT CURRENT_TIMESTAMP)

セキュリティに関する考慮事項

• 危険な操作を防ぐため、SQL クエリを検証します
• 読み取り専用モードでは、すべてのデータ変更操作がブロックされます
• 本番環境では、読み取り専用モードでの実行を検討してください

ライセンス

MIT ライセンス