SQLite Database Demo

SQLite データベースのデモ

このプロジェクトでは、FastMCP アプリケーションで非同期処理に対応した SQLite データベースの使い方を紹介します。

特長

• aiosqlite を使用した非同期 SQLite データベース操作
• サンプルデータを含むデータベースの自動初期化
• 型安全なデータベースコンテキスト管理
• 適切な接続ライフサイクル管理

前提条件

• Python 3.7+
• pip（Python パッケージインストーラー）

インストール

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

pip install -r requirements.txt

プロジェクト構成

• server.py：データベースコンテキスト管理を備えた FastMCP サーバーのメイン実装
• database.py：非同期処理に対応した SQLite データベースの実装
• demo.db：SQLite データベースファイル（初回起動時に自動作成）

データベーススキーマ

デモデータベースには、次の構造を持つ users テーブルが含まれています：

CREATE TABLE users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL
)

サンプルデータは初回起動時に自動的に挿入されます：

• John Doe（[email protected]）
• Jane Smith（[email protected]）

使い方

1. サーバーを起動します：

python server.py

2. 初回起動時に、サンプルデータを含むデータベースが自動的に初期化されます。

3. query_db ツールを使って、データベースからデータを取得します。

データベース操作

Database クラスには、次のメソッドが用意されています：

• connect()：新しいデータベース接続を作成し、スキーマを初期化します
• query()：すべてのユーザーを取得するサンプルクエリを実行します
• disconnect()：データベース接続を閉じます

カスタマイズ

データベーススキーマを変更したり、新しいテーブルを追加したりするには：

1. database.py の _init_db() メソッドを編集します
2. カスタムクエリ用のメソッドを Database クラスに追加します
3. 新しいメソッドを使用するよう、server.py の query_db ツールを更新します

エラー処理

データベースの実装には、次の機能が含まれています：

• サーバー終了時の接続の自動クリーンアップ
• 適切な非同期コンテキスト管理
• Python の型ヒントによる型安全性

依存関係

• aiosqlite>=0.19.0：非同期 SQLite データベースドライバー
• pandas>=2.0.0：データ操作ライブラリ
• numpy>=1.24.0：数値計算ライブラリ