PocketBase MCP Server

PocketBase MCP Server

site icon
2025.03.27 31
JavaScript数据库管理数据操作数据库
PocketBase MCP Server 是一个基于 Dynamics 的 MCP 服务器,专为与 PocketBase 数据库交互而设计。它提供了高级的数据库操作、模式管理和数据操作功能,通过 Model Context Protocol (MCP) 实现。该服务器支持集合管理、记录操作、用户管理和数据库备份等功能,适用于需要高效管理 PocketBase 数据库的场景。
View on GitHub

Overview

基本能力

产品定位

PocketBase MCP Server 是一个专为 PocketBase 数据库设计的 MCP 服务器,提供高级的数据库操作和管理功能。

核心功能

  1. 集合管理:创建和管理具有自定义模式的集合,检索集合模式和元数据。
  2. 记录操作:支持记录的增删改查(CRUD),关系扩展支持,分页和基于游标的导航。
  3. 用户管理:用户认证和令牌管理,用户账户创建和管理,密码管理。
  4. 数据库操作:数据库备份。

适用场景

  • 需要高效管理 PocketBase 数据库的开发项目。
  • 需要自动化数据库操作的场景。
  • 需要高级用户管理和认证功能的应用程序。

工具列表

  1. 集合管理
  2. create_collection:创建具有自定义模式的新集合。
  3. get_collection:获取集合的模式详细信息。
  4. 记录操作
  5. create_record:在集合中创建新记录。
  6. list_records:列出记录,支持过滤和分页。
  7. update_record:更新现有记录。
  8. delete_record:删除记录。
  9. 用户管理
  10. authenticate_user:认证用户并获取认证令牌。
  11. create_user:创建新用户账户。
  12. 数据库操作
  13. backup_database:创建 PocketBase 数据库的备份,支持多种格式。

常见问题解答

  • 为什么选择 PocketBase MCP Server 而不是 DynamicsEndpoints?
  • 因为 PocketBase MCP Server 已经在最新版本的 PocketBase(当前为 26.1)上进行了测试,并且基于 JS-SDK 的类型定义,而不是 Dynamics 中错误的定义。

使用教程

使用依赖

  1. 确保已安装 Node.js 环境。
  2. 确保已安装 PocketBase 并运行在本地或远程服务器上。

安装教程

  1. 定位 cline_mcp_settings.json 文件:通常在 Cursor 用户设置目录中,例如: /Users/yourusername/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  2. 配置服务器:在 cline_mcp_settings.json 文件的 mcpServers 对象中添加新条目,配置如下: json { "mcpServers": { "pocketbase-server": { "command": "node", "args": [ "build/index.js" ], "env": { "POCKETBASE_URL": "http://127.0.0.1:8090", "POCKETBASE_ADMIN_EMAIL": "[email protected]", "POCKETBASE_ADMIN_PASSWORD": "admin_password" }, "disabled": false, "autoApprove": [ "create_record", "create_collection" ] } } }
  3. 启动服务器:配置完成后,即可使用 MCP 服务器。

调试方式

  1. 确保 POCKETBASE_URL 环境变量正确指向 PocketBase 实例。
  2. 检查 cline_mcp_settings.json 文件中的路径和参数是否正确。
  3. 使用 node build/index.js 命令手动启动服务器,查看是否有错误输出。

许可证

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