Pocketbase

Name: Pocketbase
Author: tokenscompany

@tokenscompany

代码仓库

关于 Pocketbase

暂无概览

基本信息

分类

其他

传输方式

stdio

发布者

tokenscompany

提交者

0xK

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "pocketbase": {
      "type": "http",
      "url": "https://pocketbase.tokenscompany.co/mcp",
      "headers": {
        "X-PB-URL": "https://your-pocketbase.example.com",
        "X-PB-Token": "your-superuser-token"
      }
    }
  }
}

工具

PocketBase health check

List all collections with full field schemas

Get a single collection's full schema

Create a new collection

Update a collection's schema or rules

Delete a collection

Bulk import/overwrite collection schemas

List/search records in a collection

Get a single record by ID

Create a new record

Update an existing record

Delete a record by ID

List available backups

Create a new backup

Delete a backup by key

Get download URL for a file field

Get app settings

Update app settings

Query request logs

概览

What is Pocketbase?

Remote MCP server that connects any MCP client to a PocketBase instance over stateless HTTP. It is built for developers managing PocketBase backends via AI agents.

How to use Pocketbase?

Use the hosted instance at https://pocketbase.tokenscompany.co/mcp with HTTP transport (not SSE). Configure required headers: X-PB-URL (your PocketBase instance URL) plus either X-PB-Email + X-PB-Password or X-PB-Token. Self‑host via Bun or Docker.

Key features of Pocketbase

Stateless HTTP MCP server for PocketBase
Full CRUD on collections, records, backups, and settings
Two auth methods: email+password or token
Open source (MIT) with SLSA provenance attestation
SSRF protection, rate limiting, and CORS support
No credential storage, no telemetry, no sessions

Use cases of Pocketbase

Manage PocketBase collections and records through an AI agent
Automate backup creation and deletion
Query and update app settings programmatically
Bulk import or overwrite collection schemas

FAQ from Pocketbase

What transport does this server use?

Stateless streamable HTTP, not SSE. Use "type": "http" in MCP config and --transport http in Claude Code CLI.

How do I authenticate?

Provide X-PB-URL plus either X-PB-Email and X-PB-Password (recommended) or X-PB-Token. If both are given, the token takes priority.

Does the server store my data or credentials?

No. It is fully stateless: no database, no disk writes, no credential persistence, no sessions, and no telemetry. Every request is processed and discarded immediately.

Can I self-host Pocketbase?

Yes. Run with Bun (bun install && bun run src/index.ts) or Docker using ghcr.io/tokenscompany/pocketbase-mcp:latest. No external dependencies beyond your PocketBase instance.

What security features are included?

SSRF protection (private IP ranges rejected), rate limiting (default 60 requests/min per IP with burst 10), CORS with Access-Control-Allow-Origin: *, and a 1 MB body size limit.