高级PocketBase MCP服务器

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

<a href="https://glama.ai/mcp/servers/z2xjuegxxh"><img width="380" height="200" src="https://gips1.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
• 多个部署目标的环境变量管理
• 对网络和认证失败的全面错误处理
• 长时间运行会话的资源清理和内存管理

此次重大发布将高级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工具注册的语法和结构

技术改进

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

此次发布将高级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限制
• 提高了整体代码稳定性和可维护性

此次发布确保了高级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工具，用于实时事件订阅（需要eventsourcepolyfill）。

修复

• 修正了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：以创建/更新/upsert模式导入数据到集合

用户管理

• 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：使用各种模式导入数据（创建/更新/upsert）

🔧 生产诊断及管理工具

• debug_pocketbase_auth：测试认证和连接状态
• check_pocketbase_write_permissions：分析写操作能力
• analyze_pocketbase_capabilities：记录可用与受限的操作
• pocketbase_super_admin_auth：运行时作为超级管理员进行身份验证
• get_server_status：综合服务器状态和配置
• health_check：简单的健康检查端点

🛡️ 超级管理员操作

使用pocketbase_super_admin_auth后，这些管理员级别的操作变得可用：

• 集合创建和模式修改
• 用户管理和认证设置
• 系统配置更改
• 数据库管理任务

注意：生产环境可能为了安全原因