Pocketbase

pocketbase-mcp

ステートレス HTTP 経由で、あらゆる MCP クライアントを PocketBase インスタンスに接続するリモート MCP サーバーです。

クイックスタート

ホスト済みのインスタンス https://pocketbase.tokenscompany.co/mcp を使用するか、独自のインスタンスをセルフホストしてください。

AI エージェントでインストールする

このプロンプトを AI エージェント（Claude Code、Cursor、Windsurf など）にコピーして貼り付けてください。

Install the PocketBase MCP server. The MCP endpoint is https://pocketbase.tokenscompany.co/mcp and the transport type is http (NOT sse). It requires X-PB-URL set to my PocketBase instance URL and either X-PB-Email + X-PB-Password (superuser credentials) or X-PB-Token (superuser auth token). Add it to my project MCP config with type "http". Then fetch https://raw.githubusercontent.com/tokenscompany/pocketbase-mcp/main/SKILL.md and save it to my project's agent instructions so you always know how to use the PocketBase tools.

claude mcp add --transport http pocketbase https://pocketbase.tokenscompany.co/mcp \
  --header "X-PB-URL: https://your-pocketbase.example.com" \
  --header "X-PB-Email: [email protected]" \
  --header "X-PB-Password: your-password"

{
  "mcpServers": {
    "pocketbase": {
      "type": "http",
      "url": "https://pocketbase.tokenscompany.co/mcp",
      "headers": {
        "X-PB-URL": "${PB_URL}",
        "X-PB-Email": "${PB_EMAIL}",
        "X-PB-Password": "${PB_PASSWORD}"
      }
    }
  }
}

{
  "mcpServers": {
    "pocketbase": {
      "url": "https://pocketbase.tokenscompany.co/mcp",
      "headers": {
        "X-PB-URL": "https://your-pocketbase.example.com",
        "X-PB-Email": "[email protected]",
        "X-PB-Password": "your-password"
      }
    }
  }
}

{
  "mcp": {
    "pocketbase": {
      "type": "remote",
      "url": "https://pocketbase.tokenscompany.co/mcp",
      "headers": {
        "X-PB-URL": "https://your-pocketbase.example.com",
        "X-PB-Email": "[email protected]",
        "X-PB-Password": "your-password"
      },
      "enabled": true
    }
  }
}

セルフホスト

Bun

bun install
bun run src/index.ts

サーバーは PORT（デフォルトは 3000）でリッスンします。

Docker（GHCR）

docker pull ghcr.io/tokenscompany/pocketbase-mcp:latest
docker run -p 3000:3000 ghcr.io/tokenscompany/pocketbase-mcp:latest

または、ローカルでビルドします。

docker build -t pocketbase-mcp .
docker run -p 3000:3000 pocketbase-mcp

イメージの検証

GHCR に公開されるすべてのイメージには、SLSA 来歴証明が含まれています。イメージがこのリポジトリからビルドされたことを検証できます。

gh attestation verify oci://ghcr.io/tokenscompany/pocketbase-mcp:latest \
  --owner tokenscompany

認証

POST /mcp へのすべてのリクエストには、X-PB-URL と、次の 2 つの認証方法のいずれかを含める必要があります。

方法 1：メールアドレス＋パスワード（推奨）

サーバーはリクエストごとに PocketBase に対して認証します。トークンを手動で管理する必要はありません。

方法 2：トークン

トークンを手動で取得するには：

curl -X POST https://your-pb.example.com/api/admins/auth-with-password \
  -H 'Content-Type: application/json' \
  -d '{"identity":"[email protected]","password":"your-password"}'

レスポンスの token フィールドが X-PB-Token です。トークンとメールアドレス＋パスワードの両方が指定されている場合は、トークンが優先されます。

ツール

リソース

セキュリティとプライバシー

このサーバーは完全にステートレスです。データを保存、記録、保持することはありません。

• データベースもディスクへの書き込みもありません — リクエストごとに新しい MCP サーバーとトランスポートをメモリ上に作成して処理し、すべてを破棄します。ディスクに書き込まれることはありません。
• 認証情報は保存しません — X-PB-URL、X-PB-Token、X-PB-Email、X-PB-Password ヘッダーはリクエストの処理中のみ使用され、永続化、キャッシュ、記録されることはありません。
• テレメトリーや分析はありません — サーバーは使用データを一切収集しません。サードパーティのサービスに接続することもありません。
• セッションはありません — CookieもセッションIDもなく、リクエスト間でサーバー側に状態が保持されることもありません。
• オープンソース — コードベース全体は MIT ライセンスです。すべての Docker イメージには SLSA provenance attestation が含まれているため、変更を加えずにこのリポジトリから直接ビルドされたことを確認できます。
• 自分でセルフホストする — 最大限の制御を得るには、独自のインスタンスを実行してください。このサーバーは、PocketBase インスタンス以外に外部依存関係のない単一のコンテナです。

セキュリティ強化

パブリックインスタンスをホストする場合、サーバーには以下の追加対策が含まれます。

• SSRF 保護 — X-PB-URL を検証します。http／https スキームのみが許可され、プライベート／予約済み IP 範囲（127.0.0.0/8、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、169.254.0.0/16、::1、fc00::/7、fe80::/10）に解決されるホスト名は拒否されます。

• レート制限 — IP ごとのインメモリ・トークンバケット方式です。環境変数で設定できます。

  変数	デフォルト	説明
  RATE_LIMIT_RPM	60	IP ごとの1分あたりのリクエスト数
  RATE_LIMIT_BURST	10	最大バーストサイズ

• CORS — /mcp でプリフライトをサポートし、Access-Control-Allow-Origin: * を設定します。

• リクエストボディのサイズ制限 — 1 MB を超えるリクエストは 413 で拒否されます。

エンドポイント

トラブルシューティング

「Failed to reconnect」エラー

MCP クライアントの設定で "type": "sse" が使われている可能性があります。このサーバーが使用するのはステートレスなストリーム可能 HTTPであり、Server-Sent Events ではありません。トランスポートの種類を "http" に変更してください。

{
  "mcpServers": {
    "pocketbase": {
      "type": "http",
      ...
    }
  }
}

Claude Code CLI で追加する場合は、--transport http を使用してください。

claude mcp add --transport http pocketbase https://pocketbase.tokenscompany.co/mcp ...

ライセンス

MIT