Sqlite Anet MCP

🚀 SQLite-Anet-MCP 服務器

本項目是基於 Model Control Protocol (MCP) 的 Rust 實現，藉助標準化協議實現對 SQLite 數據庫的訪問。它允許 AI 代理直接對 SQLite 數據庫進行創建、管理和查詢操作，為數據庫交互提供了便捷途徑。

該項目參考了 Model Context Protocol SQLite Server 的實現。

🚀 快速開始

本服務器允許 AI 代理直接創建、管理和查詢 SQLite 數據庫。克隆倉庫並構建服務器後，配置相關環境變量，即可運行服務器並通過指定接口進行訪問。

✨ 主要特性

• 🗃️ 可創建和管理 SQLite 數據表。
• 🔍 能執行 SELECT 查詢以檢索數據。
• ✏️ 支持執行 INSERT、UPDATE 和 DELETE 查詢來操作數據。
• 📊 可描述表結構並列出可用表。
• 📝 能夠保存和綜合業務洞察。
• 🔄 採用 NATS 傳輸層進行消息傳遞。
• 🛠️ 兼容 JSON-RPC 2.0 API。
• ⚡ 利用 Tokio 實現異步請求處理。

📦 安裝指南

配置要求

• Rust 需 1.70+ 版本。
• 需有運行中的 NATS 服務器（可本地或通過網絡訪問）。
• SQLite 作為 Rust 依賴項包含在內。

安裝步驟

克隆倉庫並構建服務器：

git clone https://github.com/yourusername/sqlite-anet-mcp.git
cd sqlite-anet-mcp

在環境中配置變量，創建一個 .env 文件：

NATS_SERVER=nats://localhost:4222
SQLITE_DB=path/to/your/database.db

💻 使用示例

啟動服務器

運行服務器：

cargo run --release

訪問工具接口：http://localhost:8080

測試方法

1. 啟動 NATS 服務器。
2. 運行測試腳本：

cargo test

3. 使用示例請求進行交互。

示例請求

{
  "method": "query_data",
  "params": {
    "table": "users",
    "columns": ["id", "name", "email"],
    "conditions": []
  }
}

響應示例：

{
  "status": "success",
  "data": [
    { "id": 1, "name": "Alice", "email": "alice@example.com" },
    { "id": 2, "name": "Bob", "email": "bob@example.com" }
  ]
}

📚 詳細文檔

可用工具

數據庫操作工具

• create_table：用於創建新表。
• query_data：可執行自定義查詢。
• insert_data：能插入數據記錄。
• update_record：可更新指定記錄。
• delete_record：用於刪除指定記錄。

業務洞察資源

• business_insights：可生成和管理業務洞察報告。

開發指南

添加新功能

若要擴展服務器的功能，可按以下步驟操作：

1. 在 src/models/sqlite.rs 中定義響應結構。
2. 在 src/tools/ 文件夾中實現工具，遵循 Tool 特性。
3. 在 src/main.rs 中註冊新工具。

故障排除

• 需確保 NATS 服務器正在運行且可訪問。
• 檢查 SQLite 數據庫路徑是否正確設置。
• 驗證請求格式與每個工具的輸入模式匹配。

📄 許可證

本項目採用 MIT License。

致謝

該項目基於 Anet MCP Server 框架，並參考了 Model Context Protocol SQLite Server 的實現。