PocketBase MCP 服务器

一个基于 Dynamics 的 MCP 服务器，目前正在进行测试和改进。它提供了与 PocketBase 数据库交互的复杂工具。该服务器通过模型上下文协议 (MCP) 支持高级数据库操作、模式管理和数据操作。

为什么是这个而不是 DynamicsEndpoints？

这实际上已经在最新版本上测试过了。目前是 PocketBase 26.1 版本，它基于 JS-SDK 中的类型定义构建，而不是 Dynamics 中那些随意且错误的定义。很多方法甚至都无法正常工作。

本地设置 MCP 服务器（目前唯一支持的方式）

要在本地设置 MCP 服务器，您需要在cline_mcp_settings.json或您使用的任何文件（claude、cursor 等，配置看起来完全一样，您只需找到它的存储位置）中进行配置。操作方法如下：

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对象中添加一个新条目。该条目的键应为服务器的唯一名称（例如，“pocketbase-server”），值应为包含服务器配置的对象。
   { "mcpServers": { "pocketbase-server": { "command": "node", "args": [ "build/index.js" ], "env": { "POCKETBASE_URL": "http://127.0.0.1:8090", "POCKETBASE_ADMIN_EMAIL": "admin@example.com", "POCKETBASE_ADMIN_PASSWORD": "admin_password" }, "disabled": false, "autoApprove": [ "create_record", "create_collection" ] } } }
   • command ：启动服务器的命令（通常是node ）。
   • args ：传递给命令的参数数组。它应该指向 MCP 服务器已编译的 JavaScript 文件（例如build/index.js ）。请确保路径正确。
   • env ：包含环境变量的对象。
     • POCKETBASE_URL ：你的 PocketBase 实例的 URL。此参数为必填项。
     • POCKETBASE_ADMIN_EMAIL ：您的 PocketBase 实例的管理员电子邮件（可选，但某些操作需要）。
     • POCKETBASE_ADMIN_PASSWORD ：您的 PocketBase 实例的管理员密码（可选，但某些操作需要）。
   • disabled ：是否在启动时禁用服务器。
   • autoApprove ：自动批准的工具列表。
   • 调整env对象中的值以匹配您的 PocketBase 实例的设置。
3. **启动服务器：**配置cline_mcp_settings.json文件后，您可以开始使用已配置的工具来使用 MCP 服务器。

特征

收藏管理

• 使用自定义架构创建和管理集合
• 检索集合架构和元数据

记录操作

• 记录的 CRUD 操作
• 关系扩展支持
• 分页和基于光标的导航

用户管理

• 用户身份验证和令牌管理
• 用户帐户创建和管理
• 密码管理

数据库操作

• 数据库备份

可用工具

收藏管理

• create_collection ：使用自定义架构创建新集合
• get_collection ：获取集合的架构详细信息

记录操作

• create_record ：在集合中创建新记录
• list_records ：列出带有可选过滤器和分页的记录
• update_record ：更新现有记录
• delete_record ：删除记录

用户管理

• authenticate_user ：验证用户并获取身份验证令牌
• create_user ：创建一个新的用户帐户

数据库操作

• backup_database ：使用格式选项创建 PocketBase 数据库的备份

配置

服务器需要以下环境变量：

• POCKETBASE_URL ：您的 PocketBase 实例的 URL（例如“ http://127.0.0.1:8090 ”）

可选的环境变量：

• POCKETBASE_ADMIN_EMAIL ：用于某些操作的管理员电子邮件
• POCKETBASE_ADMIN_PASSWORD ：管理员密码
• POCKETBASE_DATA_DIR ：自定义数据目录路径

使用示例

贡献

1. 分叉存储库
2. 创建功能分支
3. 提交你的更改
4. 推送到分支
5. 创建拉取请求