技术文档摘要

高级 PocketBase MCP 服务器

这是一款全面的 MCP 服务器，提供了与 PocketBase 数据库交互的高级工具。该服务器支持通过模型上下文协议（MCP）进行高级数据库操作、模式管理和数据操作。现在支持完整的 Cloudflare Workers 和持久对象用于无服务器部署！

<a href="https://glama.ai/mcp/servers/z2xjuegxxh"><img width="380" height="200" src="https://gips2.baidu.com/it/u=3364766100,173342891&fm=3081&app=3081&f=PNG?w=760&h=400" alt="PocketBase MCP 服务器" /></a>

更新日志

v4.0.0 (2025年6月30日) - Cloudflare Workers 和持久对象支持

新增 - 无服务器部署及生产就绪

• 🚀 Cloudflare Workers 支持：完整的无服务器部署能力
  • worker.ts：主要的 Cloudflare Worker 入口点，包含路由和请求处理
  • durable-object.ts：用于状态化 MCP 会话的高级持久对象实现
  • agent-worker-compatible.ts：优化过的 PocketBase MCP 代理
  • 完整的 WebSocket 支持，通过持久对象实现实时 MCP 连接
• 🔧 生产部署工具：可立即部署的配置
  • wrangler.toml：完整的 Cloudflare Workers 配置
  • Dockerfile 和 Dockerfile.test：开发和测试用的 Docker 支持
  • tsconfig.worker.json：特定于 Worker 的 TypeScript 配置
• 🛡️ 超级管理员身份验证：运行时管理员权限提升
  • pocketbase_super_admin_auth 工具：在运行时作为超级管理员身份验证
  • 程序化启用管理员操作（集合创建、模式更改）
  • 综合的安全分析和功能测试
• 📊 高级诊断：生产监控和调试工具
  • debug_pocketbase_auth：身份验证和连接测试
  • check_pocketbase_write_permissions：写操作能力分析
  • analyze_pocketbase_capabilities：完整的安全模型文档
  • 生产环境与开发环境检测和指导

增强 - 无服务器架构

• 🌐 多种部署选项：
  • 传统的 Node.js 服务器（现有）
  • Cloudflare Workers 与持久对象（新）
  • Docker 容器化支持（新）
• ⚡ 性能优化：
  • 持久对象休眠以提高成本效率
  • 连接池和会话管理
  • 自动重试逻辑，带有指数退避
• 🔐 企业级安全：
  • 生产安全模式检测
  • 管理操作限制，具备绕过能力
  • 综合审计日志和会话跟踪

文档

• 📖 完整的部署指南：
  • CLOUDFLARE_DEPLOYMENT.md：逐步的 Cloudflare 部署指南
  • SUPER_ADMIN_AUTH.md：超级管理员身份验证使用指南
  • OPERATION_CAPABILITIES.md：生产安全模型解释
• 🔄 迁移支持：CLOUDFLARE_AGENT.md 用于过渡到无服务器

技术改进

• 在 Node.js 和 Cloudflare Workers 中完全兼容 TypeScript
• 多个部署目标的环境变量管理
• 对网络和身份验证失败的综合错误处理
• 长时间运行会话的资源清理和内存管理

此次重大发布将 Advanced PocketBase MCP 服务器转变为一个生产就绪且支持无服务器的解决方案，可以在 Cloudflare 的全球边缘网络上部署，同时保持与传统部署的完全兼容性。

更新日志

v3.0.0 (2025年6月10日)

新增 - 完整的全栈 SaaS 后端集成

• 电子邮件服务集成：完整的电子邮件功能，支持 SMTP 和 SendGrid
  • 10 个全面的电子邮件 MCP 工具：创建/更新/删除模板，发送模板/自定义邮件
  • 电子邮件日志和模板管理系统
  • 连接测试和默认模板设置
• 增强的 Stripe 服务：先进的支付处理能力
  • 10 个额外的 Stripe MCP 工具，用于完整的支付管理
  • 创建支付意图、客户管理、订阅处理
  • 完整的 Webhook 处理和产品同步
• 全栈 SaaS 自动化：5 个完整的自动化工作流工具
  • register_user_with_automation：完整的用户注册，包括电子邮件和 Stripe 客户创建
  • create_subscription_flow：端到端订阅设置，带电子邮件通知
  • process_payment_webhook_with_email：Webhook 处理，自动发送电子邮件通知
  • setup_complete_saas_backend：一键初始化 SaaS 后端
  • cancel_subscription_with_email：订阅取消，带客户通知
• 生产就绪监控：后端状态监控和健康检查
  • get_saas_backend_status：全面的状态报告，确保生产就绪
  • 服务健康检查、集合验证、模板验证
  • 生产就绪评估和建议

增强的服务

• EmailService：添加了 updateTemplate() 和 testConnection() 方法
• StripeService：添加了 createPaymentIntent()、retrieveCustomer()、updateCustomer()、cancelSubscription() 方法
• 高级集合：自动设置 stripe_products、stripe_customers、stripe_subscriptions、stripe_payments、email_templates、email_logs

修复

• TypeScript 语法错误：解决了 index.ts 中的所有编译错误
• 导入语句：修复了 email.ts 服务中的畸形导入
• 工具注册：纠正了 MCP 工具注册的语法和结构

技术改进

• 所有新服务和工具的完整类型安全性
• 所有电子邮件和支付操作的综合错误处理
• 模块化的服务架构，具有明确的关注分离
• 所有外部服务的基于环境的配置

此次发布将 Advanced PocketBase MCP 服务器转变为一个完整的全栈 SaaS 后端解决方案，提供用户管理、支付处理、电子邮件通信和业务自动化所需的一切，通过模型上下文协议实现。

更新日志

v2.3.0 (2025年6月12日)

新增 - SDK 兼容性和现代化

• 完整的 SDK 兼容性：与最新版本的 PocketBase JavaScript SDK v0.26.1 完全兼容
• 现代类型定义：完全重写了 src/types/pocketbase.d.ts，以匹配实际的 SDK API
  • 为 CollectionService、RecordService、FileService、HealthService、RealtimeService 添加了正确的接口
  • 更新了 AuthStore、AuthData、AuthMethodsList 的正确方法签名
  • 移除了当前 SDK 版本中不存在的不兼容功能
• 身份验证方法现代化：更新所有身份验证工具以使用当前的 SDK 模式
  • 修正了 authenticate_with_otp 使用 requestOTP() 来启动 OTP 流程
  • 更新了 authenticate_with_oauth2 使用 authWithOAuth2Code() 并带有正确的参数
  • 将方法命名从 authWithOtp 更改为 authWithOTP，以匹配 SDK
  • 修正了所有 AuthStore 引用，从已弃用的 model 属性更改为正确的 record 属性

修复 - SDK 兼容性问题

• 移除不兼容的功能：清理了使用不存在的 SDK 方法的工具
  • 移除了 get_collection_scaffolds 工具（使用了不存在的 collections.getScaffolds()）
  • 移除了 import_collections 工具（使用了不存在的 collections.import()）
  • 将 createBatch() API 调用替换为批处理操作工具中的顺序执行
• 接口清理：移除了 ExtendedPocketBase 接口，直接使用标准的 PocketBase 类型
• 语法修正：修复了各种语法错误，包括缺少的括号和分号
• 构建系统：成功编译 TypeScript 项目，没有错误，服务器正常启动

增强

• 工具注册：所有 MCP 工具注册现在遵循正确的模式，并利用现代 SDK 功能
• 错误处理：在整个身份验证和数据操作过程中改进了错误处理
• 类型安全性：通过准确的类型定义增强了 TypeScript 支持，匹配 SDK v0.26.1
• 文档：创建了详细的 CHANGELOG.md，记录了所有更改和破坏性更改

技术改进

• 验证了与 MCP TypeScript SDK v1.12.1 的兼容性
• 确保所有工具实现使用实际的 PocketBase SDK v0.26.1 方法
• 将批处理操作替换为顺序执行，以适应 SDK 的限制
• 提高了整体代码的稳定性与可维护性

此次发布确保 Advanced PocketBase MCP 服务器与最新的 SDK 版本完全兼容，并遵循现代开发模式。

v2.2.0 (2025年6月7日)

新增

• SSE 传输支持：增加了 Server-Sent Events 传输，以实现实时流媒体功能
• 多种传输选项：现支持 stdio、HTTP 和 SSE 传输
• 实时流媒体：增强了 stream_collection_changes 工具，使用 MCP 通知系统
• HTTP 服务器模式：新的 HTTP 服务器，带有健康检查端点
• Express 集成：增加了 Express.js 以实现 HTTP/SSE 服务器功能
• 可流式传输的 HTTP 协议：支持最新的 MCP 协议版本 2025-03-26
• 向后兼容性：维持对旧版 HTTP+SSE 协议 2024-11-05 的支持

更新

• MCP SDK：更新至最新版本 1.12.1
• PocketBase SDK：更新至最新版本 0.26.1
• TypeScript 支持：增强了类型定义和错误处理
• 包脚本：增加了针对不同服务器模式的新 npm 脚本

增强

• 文档：全面更新了 README，增加了 SSE 示例
• 错误处理：改进了错误消息和类型安全性
• 开发体验：更好的 TypeScript 集成和调试

技术改进

• 增加了 Express 类型以获得更好的 TypeScript 支持
• 增强了 SSE 连接的会话管理
• 改进了传输生命周期管理
• 在服务器关闭时更好地清理资源

更新日志

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 错误
• 改进了带有适当类型注释的模式字段处理
• 修复了可选模式字段属性的问题

变更

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

🚀 部署选项

Smithery 平台（托管主机）⭐ 推荐给初学者

部署到 Smithery 的托管平台，无需基础设施管理即可托管 MCP 服务器：

优点：

• 🌐 托管 MCP 服务器，带有交互式网页游乐场
• 🔧 零基础设施或部署复杂性
• 🔍 内置测试和发现工具
• 📊 使用分析和监控仪表板
• 🛡️ 自动安全更新和维护

快速设置：

1. 访问 Smithery PocketBase 服务器
2. 点击“部署”并连接您的 GitHub 账户
3. 配置您的 PocketBase URL 和可选的管理员凭据
4. 立即使用网页游乐场

配置选项：

• pocketbaseUrl：您的 PocketBase 实例 URL（必需）
• adminEmail：用于高级操作的管理员电子邮件（可选）
• adminPassword：用于高级操作的管理员密码（可选）
• debug：启用调试日志（可选，默认值：false）

Cloudflare Workers（生产规模）

部署到 Cloudflare 的全球边缘网络，使用持久对象进行状态化 MCP 会话：

快速部署：

# 克隆并部署
git clone https://github.com/your-username/advanced-pocketbase-mcp-server
cd advanced-pocketbase-mcp-server
npm install
npm run build
npx wrangler deploy

优点：

• ⚡ 全球边缘部署，延迟低于 100 毫秒
• 💰 按需付费定价（提供免费层级）
• 🔄 自动扩展和负载均衡
• 🛡️ 内置安全和 DDoS 保护
• 📊 高级诊断和监控工具

传统的 Node.js 服务器

标准部署用于开发和传统托管：

npm install
npm run build
npm start

Docker 部署

容器化部署适用于任何平台：

docker build -t pocketbase-mcp-server .
docker run -p 3000:3000 -e POCKETBASE_URL=your_url pocketbase-mcp-server

功能

集合管理

• 创建和管理带有自定义模式的集合
• 迁移集合模式，保留数据
• 高级索引管理（创建、删除、列出）
• 模式验证和类型安全性
• 获取集合模式和元数据

记录操作

• 记录的 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