Model Context Protocol Examples

🚀 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（john@example.com）
• Jane Smith（jane@example.com）

使用方法

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 型ヒントを使用した型安全