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。