Advanced PocketBase MCP Server

基本能力

产品定位

Advanced PocketBase MCP Server 是一个专门用于与 PocketBase 数据库进行高级交互的服务器，通过 Model Context Protocol (MCP) 提供丰富的数据库操作和管理功能。

核心功能

1. 集合管理：创建和管理集合，支持自定义模式、模式迁移和索引管理。
2. 记录操作：支持CRUD操作、高级查询、批量操作和实时订阅。
3. 用户管理：用户认证、密码管理、角色访问控制和会话管理。
4. 数据库操作：数据库备份和恢复、数据导入/导出、数据迁移和索引优化。

适用场景

• Web应用后端开发
• 数据迁移和批量数据处理
• 实时数据监控和订阅
• 用户认证和权限管理

工具列表

1. 集合管理工具：
2. create_collection：创建新集合
3. get_collection_schema：获取集合模式
4. migrate_collection：迁移集合模式
5. manage_indexes：管理索引
6. 记录操作工具：
7. create_record：创建记录
8. list_records：列出记录
9. update_record：更新记录
10. delete_record：删除记录
11. query_collection：高级查询
12. batch_update_records：批量更新记录
13. batch_delete_records：批量删除记录
14. subscribe_to_collection：实时订阅集合变更
15. 用户管理工具：
16. authenticate_user：用户认证
17. create_user：创建用户
18. list_auth_methods：列出认证方法
19. auth_refresh：刷新认证令牌
20. 数据库操作工具：
21. backup_database：备份数据库
22. import_data：导入数据

常见问题解答

1. 如何安装 eventsource 包？
2. 在 Node.js 环境中运行 npm install eventsource。
3. 如何配置环境变量？
4. 复制 .env.example 到 .env 并配置 POCKETBASE_URL 等变量。
5. 如何解决认证错误？
6. 确保 POCKETBASE_ADMIN_EMAIL 和 POCKETBASE_ADMIN_PASSWORD 正确配置。

使用教程

使用依赖

1. 安装 Node.js 环境。
2. 安装 PocketBase 实例并确保其运行。

安装教程

1. 克隆仓库： bash git clone <repository-url>
2. 安装依赖： bash npm install
3. 配置环境变量： bash cp .env.example .env 编辑 .env 文件，设置 POCKETBASE_URL 等变量。
4. 构建项目： bash npm run build
5. 启动服务器： bash npm start

调试方式

1. 检查服务器日志以查看连接状态和错误信息。
2. 使用 console.log 或调试工具检查工具调用和响应。
3. 确保 PocketBase 实例正常运行并可访问。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。