MCP Sqlite Server

🚀 SQLite MCP サーバー

このリポジトリには、Python で書かれた MCP（モデルコンテキストプロトコル）サーバーが含まれています。このサーバーは、スタートアップの融資データを含む SQLite データベースに接続します。サーバーは、テーブル構造をリソースとして公開し、読み取り専用の SQL クエリツールを提供し、一般的なデータ分析タスクのプロンプトテンプレートを提供します。MCP クライアントと大規模言語モデル（LLM）と一緒に使用するように設計されており、STDIO プロトコルを通じて通信します。

🚀 クイックスタート

概要

MCP サーバーは MCP Python SDK（CLI 拡張機能付き）を使用して、以下の機能を実現します。

• SQLite データベースへの接続（例：スタートアップの融資情報を含むデータベース）
• 特定のテーブル構造を MCP リソースとして公開
• 読み取り専用の SQL クエリを実行するツールの提供
• 言語モデルがデータ分析の洞察を生成するのを支援するプロンプトテンプレートの提供
• STDIO プロトコルを通じた通信：標準入力から JSON - RPC メッセージを読み取り、応答を標準出力に書き込む

✨ 主な機能

リソース

• schema://sqlite/{table}：特定のテーブルの SQL 構造を返します。
• schema://sqlite/all：すべてのテーブル構造の JSON マッピングを返します。

ツール

• sql_query：読み取り専用の SQL クエリを実行します。SELECT 文のみ許可されます。

プロンプト

• analyze_table_prompt：特定のテーブルの分析プロンプトを生成します。
• describe_query_prompt：SQL クエリを説明するプロンプトを生成します。

STDIO プロトコル

• stdin から読み取り、応答を stdout に書き込むため、簡単に統合できます。

ロギング

• Python の logging モジュールを使用して、アクティビティを追跡し、エラーをデバッグします。

📦 インストール

サンプル SQLite データベースの作成

以下のスクリプトを create_db.py として保存します。

<同上>

以下のコマンドを実行します。

python create_db.py

仮想環境の作成

python -m venv venv

環境をアクティブ化します。

• macOS/Linux：

  source venv/bin/activate
  

• Windows：

  venv\Scripts\activate
  

依存関係をインストールします。

pip install "mcp[cli]"

MCP サーバーの実行

1. サーバーコードを sqlite_mcp_server.py として保存します。
2. サーバーを実行します。

python sqlite_mcp_server.py

uv をオプションで使用できます。

uv run sqlite_mcp_server.py

Claude Desktop へのインストール

以下の内容を install_to_claude.py として保存し、実行します。

python install_to_claude.py

💻 使用例

基本的な使用法

MCP サーバーからテーブル構造を取得する

mcp server --host localhost:5000 --get schema://sqlite/sales

SQL クエリを実行する

mcp server --host localhost:5000 --query "SELECT * FROM sales LIMIT 5"

クエリの説明を生成する

mcp server --host localhost:5000 --describe "SELECT COUNT(*) FROM customers WHERE state = 'CA'"

📚 ドキュメント

MCP CLI ツールを使用したサーバーのテスト

MCP CLI のインストール

pip install mcp-cli

テーブル構造取得のテスト

mcp test --host localhost:5000 --test-get schema://sqlite/sales

SQL クエリ実行のテスト

mcp test --host localhost:5000 --test-query "SELECT * FROM sales LIMIT 5"

ログ記録

ログファイルの設定

logging_config.json に以下の内容を追加します。

{
  "version": 1,
  "handlers": {
    "file_handler": {
      "class": "logging.FileHandler",
      "filename": "mcp_server.log",
      "level": "INFO"
    }
  },
  "root": {
    "level": "INFO",
    "handlers": ["file_handler"]
  }
}

ログ記録の有効化

sqlite_mcp_server.py に以下の内容を追加します。

import logging
from logging.config import fileConfig

fileConfig("logging_config.json")
logger = logging.getLogger()

def main():
    # ...
    logger.info("Starting MCP Server")
    # ...

if __name__ == "__main__":
    main()

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。