
PocketBase MCP Server

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 服务器,提供高级的数据库操作和管理功能。
核心功能
- 集合管理:创建和管理具有自定义模式的集合,检索集合模式和元数据。
- 记录操作:支持记录的增删改查(CRUD),关系扩展支持,分页和基于游标的导航。
- 用户管理:用户认证和令牌管理,用户账户创建和管理,密码管理。
- 数据库操作:数据库备份。
适用场景
- 需要高效管理 PocketBase 数据库的开发项目。
- 需要自动化数据库操作的场景。
- 需要高级用户管理和认证功能的应用程序。
工具列表
- 集合管理
create_collection
:创建具有自定义模式的新集合。get_collection
:获取集合的模式详细信息。- 记录操作
create_record
:在集合中创建新记录。list_records
:列出记录,支持过滤和分页。update_record
:更新现有记录。delete_record
:删除记录。- 用户管理
authenticate_user
:认证用户并获取认证令牌。create_user
:创建新用户账户。- 数据库操作
backup_database
:创建 PocketBase 数据库的备份,支持多种格式。
常见问题解答
- 为什么选择 PocketBase MCP Server 而不是 DynamicsEndpoints?
- 因为 PocketBase MCP Server 已经在最新版本的 PocketBase(当前为 26.1)上进行了测试,并且基于 JS-SDK 的类型定义,而不是 Dynamics 中错误的定义。
使用教程
使用依赖
- 确保已安装 Node.js 环境。
- 确保已安装 PocketBase 并运行在本地或远程服务器上。
安装教程
- 定位
cline_mcp_settings.json
文件:通常在 Cursor 用户设置目录中,例如:/Users/yourusername/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- 配置服务器:在
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" ] } } }
- 启动服务器:配置完成后,即可使用 MCP 服务器。
调试方式
- 确保
POCKETBASE_URL
环境变量正确指向 PocketBase 实例。 - 检查
cline_mcp_settings.json
文件中的路径和参数是否正确。 - 使用
node build/index.js
命令手动启动服务器,查看是否有错误输出。