Model Context Protocol Examples

🚀 SQLite 數據庫演示

本項目聚焦於在 FastMCP 應用裡，展示具備異步支持的 SQLite 數據庫的具體使用方式，為開發者提供便捷高效的數據管理解決方案。

🚀 快速開始

先決條件

• Python 3.7+
• pip（Python 包安裝工具）

安裝步驟

1. 克隆此倉庫。
2. 安裝所需的依賴項：

pip install -r requirements.txt

啟動項目

1. 啟動服務器：

python server.py

2. 數據庫將在首次運行時自動初始化並插入示例數據。
3. 使用 query_db 工具從數據庫中檢索數據。

✨ 主要特性

• 使用 aiosqlite 實現異步 SQLite 數據庫操作，提升數據處理效率。
• 自動初始化數據庫並插入示例數據，減少手動配置步驟。
• 類型安全的數據庫上下文管理，確保數據操作的準確性。
• 正確處理連接生命週期，保障數據庫連接的穩定性。

📦 項目結構

• 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）

數據庫操作

Database 類提供以下方法：

• connect()：創建新的數據庫連接並初始化模式。
• query()：執行樣本查詢以檢索所有用戶。
• disconnect()：關閉數據庫連接。

自定義

要修改數據庫模式或添加新表：

1. 編輯 database.py 中的 _init_db() 方法。
2. 為 Database 類添加新的方法以實現自定義查詢。
3. 更新 server.py 中的 query_db 工具以使用新方法。

錯誤處理

數據庫實現包括：

• 服務器關閉時自動清理連接。
• 正確處理異步上下文管理。
• 使用 Python 類型提示實現類型安全。