PocketBase MCP 服务器

这是一个正在开发中的 MCP 服务器，基于我一直在测试和改进的 Dynamics 版本。它为与 PocketBase 数据库交互提供了复杂的工具。该服务器通过模型上下文协议 (MCP) 实现高级数据库操作、模式管理和数据操作。

为什么选择这个而不是 DynamicsEndpoints？

这个版本实际上已经在最新版本上进行了测试，目前是 PocketBase 的 26.1 版本，并且是基于 JS-SDK 中的类型定义构建的，而不是 Dynamics 版本中任意且错误的定义。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: 自定义数据目录路径

使用示例

// 创建一个新集合
await mcp.use_tool("pocketbase", "create_collection", {
  name: "posts",
  schema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    }
  ]
});

// 使用密码进行身份验证
await mcp.use_tool("pocketbase", "authenticate_user", {
  email: "user@example.com",
  password: "securepassword",
  collection: "users"
});

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request