Dynamicendpoints Pocketbase MCP Server

🚀 高級 PocketBase MCP 服務器

高級 PocketBase MCP 服務器是一個功能全面的 MCP 服務器，它提供了與 PocketBase 數據庫交互的高級工具。通過模型上下文協議（MCP），該服務器能夠實現複雜的數據庫操作、架構管理和數據處理。

點擊此處

✨ 主要特性

集合管理

• 創建和管理自定義架構的集合。
• 帶數據保留的集合遷移。
• 高級索引管理（創建、刪除、列出）。
• 架構驗證和類型安全。
• 獲取集合架構和元數據。

記錄操作

• 對記錄進行 CRUD 操作。
• 支持過濾器、排序和聚合的高級查詢。
• 具備批量導入/導出功能。
• 支持關係擴展。
• 支持分頁和遊標導航。

用戶管理

• 用戶身份驗證和令牌管理。
• 用戶賬戶創建和管理。
• 密碼管理。
• 基於角色的訪問控制。
• 會話處理。

數據庫操作

• 數據庫備份和恢復。
• 支持多種導出格式（JSON/CSV）。
• 提供數據遷移工具。
• 索引優化。
• 批處理操作。

📦 安裝指南

1. 克隆倉庫。
2. 安裝依賴：npm install。
3. 複製 .env.example 到 .env 並配置。
4. 構建：npm run build。
5. 啟動你的 PocketBase 實例。
6. MCP 服務器將自動連接到你的 PocketBase 實例。

💻 使用示例

可用工具

集合管理

• create_collection：創建具有自定義架構的新集合。
• get_collection_schema：獲取集合的架構詳細信息。
• migrate_collection：帶數據保留遷移集合架構。
• manage_indexes：創建、刪除或列出集合索引。

記錄操作

• create_record：在集合中創建新記錄。
• list_records：使用可選過濾器和分頁列出記錄。
• update_record：更新現有記錄。
• delete_record：刪除記錄。
• query_collection：使用過濾器、排序和聚合進行高級查詢。
• import_data：以創建/更新/插入模式導入數據到集合。

用戶管理

• authenticate_user：身份驗證用戶並獲取令牌。
• create_user：創建新用戶賬戶。

數據庫操作

• backup_database：創建 PocketBase 數據庫的備份。
• import_data：以指定格式導入數據。

📚 詳細文檔

錯誤處理

所有工具都包含全面的錯誤處理，帶有詳細的錯誤消息。錯誤包括：

• 無效請求錯誤
• 身份驗證錯誤
• 數據庫操作錯誤
• 架構驗證錯誤
• 網絡錯誤

類型安全

該服務器為所有操作提供 TypeScript 定義，確保類型安全。每個工具的輸入架構都經過嚴格的類型檢查和驗證。

最佳實踐

1. 總是使用適當的錯誤處理與 try/catch 塊。
2. 在執行操作前驗證數據。
3. 使用適合的索引以提高查詢性能。
4. 定期備份數據庫。
5. 對架構變更使用遷移。
6. 遵循用戶管理的安全最佳實踐。
7. 監控和優化數據庫性能。

🔧 技術細節

貢獻

1. 叉克倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建 Pull Request。