高级 PocketBase MCP 服务器

一个功能全面的 MCP 服务器，提供与 PocketBase 数据库交互的复杂工具。该服务器通过模型上下文协议 (MCP) 支持高级数据库操作、模式管理和数据操作。

变更日志

v2.1.0（2025 年 4 月 3 日）

额外

添加了batch_update_records工具，用于一次更新多个记录。
添加了batch_delete_records工具，用于一次删除多个记录。
添加了用于实时事件订阅的subscribe_to_collection工具（需要eventsource polyfill）。

固定的

修正了authenticate_user的模式，允许通过环境变量进行管理员身份验证，而无需明确的电子邮件/密码。
添加了eventsource依赖项和 polyfill，以在 Node.js 中启用实时订阅。

v2.0.0（2025 年 4 月 2 日）

额外

通过环境变量增强管理员身份验证支持
通过impersonate_user工具添加了对管理员模拟的支持
改进了身份验证操作的错误处理
添加了全面的 TypeScript 类型定义以获得更好的开发体验
增加了对 Cline 集成的支持

固定的

修复了 PocketBase 客户端实现中的 TypeScript 错误
使用适当的类型注释改进了架构字段处理
修复了可选架构字段属性的问题

已更改

更新了身份验证流程以支持多种身份验证方法
改进的文档，包含更详细的示例
增强的环境变量配置选项

特征

收藏管理

使用自定义架构创建和管理集合
迁移带有数据保存的收集模式
高级索引管理（创建、删除、列出）
架构验证和类型安全
检索集合架构和元数据

记录操作

记录的 CRUD 操作
具有过滤、排序和聚合功能的高级查询
批量导入/导出功能
关系扩展支持
分页和基于光标的导航

用户管理

用户身份验证和令牌管理
用户帐户创建和管理
密码管理
基于角色的访问控制
会话处理

数据库操作

数据库备份和恢复
多种导出格式（JSON/CSV）
数据迁移工具
索引优化
批量操作

可用工具

收藏管理

create_collection ：使用自定义架构创建新集合
get_collection_schema ：获取集合的架构详细信息
migrate_collection ：迁移带有数据保存的集合模式
manage_indexes ：创建、删除或列出集合索引

记录操作

create_record ：在集合中创建新记录
list_records ：列出带有可选过滤器和分页的记录
update_record ：更新现有记录
delete_record ：删除记录
query_collection ：具有过滤、排序和聚合功能的高级查询
batch_update_records ：在一次调用中更新多条记录
batch_delete_records ：一次调用即可删除多条记录
subscribe_to_collection ：订阅集合中的实时变化（需要 Node.js 环境中的eventsource包）
import_data ：使用创建/更新/插入模式将数据导入集合

用户管理

authenticate_user ：验证用户并获取身份验证令牌
create_user ：创建一个新的用户帐户
list_auth_methods ：列出所有可用的身份验证方法
authenticate_with_oauth2 ：使用 OAuth2 验证用户身份
authenticate_with_otp ：使用一次性密码验证用户身份
auth_refresh ：刷新身份验证令牌
request_verification ：请求电子邮件验证
confirm_verification ：使用令牌确认电子邮件验证
request_password_reset ：请求重置密码
confirm_password_reset ：使用令牌确认密码重置
request_email_change ：请求更改电子邮件
confirm_email_change ：使用令牌确认电子邮件变更
impersonate_user ：模拟其他用户（仅限管理员）

数据库操作

backup_database ：使用格式选项创建 PocketBase 数据库的备份
import_data ：使用各种模式导入数据（创建/更新/更新插入）

配置

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

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

可选的环境变量：

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

使用示例

收藏管理

// Create a new collection
await mcp.use_tool("pocketbase", "create_collection", {
  name: "posts",
  schema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    }
  ]
});

// Manage indexes
await mcp.use_tool("pocketbase", "manage_indexes", {
  collection: "posts",
  action: "create",
  index: {
    name: "title_idx",
    fields: ["title"],
    unique: true
  }
});

高级查询

// Query with filtering, sorting, and aggregation
await mcp.use_tool("pocketbase", "query_collection", {
  collection: "posts",
  filter: "created >= '2024-01-01'",
  sort: "-created",
  aggregate: {
    totalLikes: "sum(likes)",
    avgRating: "avg(rating)"
  },
  expand: "author,categories"
});

数据导入/导出

// Import data with upsert mode
await mcp.use_tool("pocketbase", "import_data", {
  collection: "posts",
  data: [
    {
      title: "First Post",
      content: "Hello World"
    },
    {
      title: "Second Post",
      content: "More content"
    }
  ],
  mode: "upsert"
});

// Backup database
await mcp.use_tool("pocketbase", "backup_database", {
  format: "json" // or "csv"
});

架构迁移

// Migrate collection schema
await mcp.use_tool("pocketbase", "migrate_collection", {
  collection: "posts",
  newSchema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    },
    {
      name: "tags",
      type: "json",
      required: false
    }
  ],
  dataTransforms: {
    // Optional field transformations during migration
    tags: "JSON.parse(oldTags)"
  }
});

批量和实时操作

// Batch update records
await mcp.use_tool("pocketbase", "batch_update_records", {
  collection: "products",
  records: [
    { id: "record_id_1", data: { price: 19.99 } },
    { id: "record_id_2", data: { status: "published" } }
  ]
});

// Batch delete records
await mcp.use_tool("pocketbase", "batch_delete_records", {
  collection: "products",
  recordIds: ["record_id_3", "record_id_4"]
});

// Subscribe to collection changes (logs events to server console)
// Note: Requires 'eventsource' package installed in the Node.js environment running the server.
await mcp.use_tool("pocketbase", "subscribe_to_collection", {
  collection: "products"
});

// Subscribe to a specific record
await mcp.use_tool("pocketbase", "subscribe_to_collection", {
  collection: "products",
  recordId: "specific_product_id"
});

身份验证方法

// List available authentication methods
await mcp.use_tool("pocketbase", "list_auth_methods", {
  collection: "users"
});

// Authenticate with password
await mcp.use_tool("pocketbase", "authenticate_user", {
  email: "user@example.com",
  password: "securepassword",
  collection: "users"
});

// Authenticate with OAuth2
await mcp.use_tool("pocketbase", "authenticate_with_oauth2", {
  provider: "google",
  code: "auth_code_from_provider",
  codeVerifier: "code_verifier_from_pkce",
  redirectUrl: "https://your-app.com/auth/callback",
  collection: "users"
});

// Request password reset
await mcp.use_tool("pocketbase", "request_password_reset", {
  email: "user@example.com",
  collection: "users"
});

// Confirm password reset
await mcp.use_tool("pocketbase", "confirm_password_reset", {
  token: "verification_token",
  password: "new_password",
  passwordConfirm: "new_password",
  collection: "users"
});

// Refresh authentication token
await mcp.use_tool("pocketbase", "auth_refresh", {
  collection: "users"
});

错误处理

所有工具均包含全面的错误处理功能，并配有详细的错误消息。错误信息均已正确输入，包括：

无效请求错误
身份验证错误
数据库操作错误
架构验证错误
网络错误

类型安全

该服务器包含所有操作的 TypeScript 定义，确保使用工具时的类型安全。每个工具的输入模式都经过严格的类型和验证。

最佳实践

始终使用 try/catch 块进行适当的错误处理
执行操作前验证数据
使用适当的索引以获得更好的查询性能
定期备份数据库
使用迁移进行架构更改
遵循用户管理的安全最佳实践
监控和优化数据库性能

发展

克隆存储库
安装依赖项： npm install
将.env.example复制到.env并配置
构建： npm run build
启动您的 PocketBase 实例
MCP 服务器将自动连接到您的 PocketBase 实例

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 PocketBase Server：

npx -y @smithery/cli install pocketbase-server --client claude

贡献

分叉存储库
创建功能分支
提交你的更改
推送到分支
创建拉取请求

pocketbase-mcp-server

Integrations

高级 PocketBase MCP 服务器

变更日志

v2.1.0（2025 年 4 月 3 日）

额外

固定的

v2.0.0（2025 年 4 月 2 日）

额外

固定的

已更改

特征

收藏管理

记录操作

用户管理

数据库操作

可用工具

收藏管理

记录操作

用户管理

数据库操作

配置

使用示例

收藏管理

高级查询

数据导入/导出

架构迁移

批量和实时操作

身份验证方法

错误处理

类型安全

最佳实践

发展

通过 Smithery 安装

贡献

Tools

Appeared in Searches