dynamic-pocketbase-mcp

PocketBase 用の動的 Model Context Protocol (MCP) サーバーです。AI クライアントを一度接続すれば、ランタイムツールを使用してあらゆる PocketBase プロジェクトのコレクションやレコードを管理できます。

このサーバーが異なる理由

多くの PocketBase MCP サーバーは静的です。つまり、コレクション固有の動作をハードコードしたり、スキーマごとにカスタムツール定義が必要になったりします。

dynamic-pocketbase-mcp は動的です：

• コレクションに依存しないツール (list_collections, list_records, create_record など) を使用します

• サーバーコードを再生成することなく、既存および新規作成されたコレクション全体で動作します

• ライブの PocketBase コレクションを MCP リソースとして公開します

Related MCP server: PocketBase MCP Server

機能

• ヘルスチェック、認証、コレクション、ルール、レコードのための 18 個の MCP ツール

• コレクションのライフサイクル操作 (作成、更新、削除、検査)

• フィルタリング、ソート、ページネーション、フィールド選択を備えたレコード CRUD

• ツールによるセッションベースの認証 (auth_admin, auth_user, get_auth_status, logout)

• フィールドスキーマおよびルール構文のための組み込みリファレンス

インストール

npm install dynamic-pocketbase-mcp
# or
bun install dynamic-pocketbase-mcp

AI クライアントでの設定

Claude Desktop

Claude Desktop の設定 (~/Library/Application Support/Claude/claude_desktop_config.json (macOS の場合)) に追加します：

{
  "mcpServers": {
    "dynamic-pocketbase": {
      "command": "npx",
      "args": ["-y", "dynamic-pocketbase-mcp"]
    }
  }
}

POCKETBASE_URL が設定されていない場合、サーバーはデフォルトで http://localhost:8090 を使用します。

直接使用する方法

# Use default URL (http://localhost:8090)
npx -y dynamic-pocketbase-mcp

# Use custom PocketBase URL
POCKETBASE_URL=https://pb.example.com \
bunx dynamic-pocketbase-mcp

簡単なチュートリアル: この MCP を使用して AI とチャットする

MCP クライアントを設定した後、チャットを開いて以下のようなプロンプトを試してください：

1. "PocketBase の URL を https://pb.example.com に設定して。"

2. "PocketBase サーバーのヘルス状態を確認して。"

3. "すべての PocketBase コレクションをリストアップして。"

4. "メールアドレス <your-email> とパスワード <your-password> で管理者として認証して。"

5. "notes という名前のコレクションを作成して。必須の title テキストフィールドを含めて。"

6. "notes に First note というタイトルのレコードを作成して。"

7. "notes の全レコードを新しい順に表示して。"

8. "PocketBase の認証セッションからログアウトして。"

これらの手順が成功すれば、AI はこの MCP サーバーを通じてスキーマとデータを管理できるようになります。

認証フロー (ツール経由)

1. auth_admin または auth_user

2. get_auth_status

3. logout

利用可能なツール

ヘルスチェックとリファレンス

• health - PocketBase サーバーのヘルス状態を確認する

• set_base_url - 現在の MCP セッションの PocketBase URL を更新し、認証トークンをクリアする

• get_field_schema_reference - フィールド型のドキュメントを取得する

• get_rules_reference - API ルールの構文リファレンスを取得する

認証

• auth_admin - 管理者/スーパーユーザーとして認証する

• auth_user - 認証コレクションのユーザーとして認証する (メールアドレス/ユーザー名)

• get_auth_status - 現在の認証状態を確認する

• logout - 認証セッションをクリアする

コレクション

• list_collections - すべてのコレクションをリストアップする

• view_collection - 名前または ID でコレクションを表示する

• create_collection - 新しいコレクションを作成する (指定がない限り、ベース/認証コレクション用に created および updated の自動日付フィールドが自動追加されます)

• update_collection - コレクションのスキーマ/設定を更新する

• delete_collection - コレクションを削除する

• update_collection_rules - アクセス制御ルールを更新する

レコード

• list_records - フィルタリング、ソート、ページネーションを使用してレコードをリスト/検索する

• view_record - ID で単一のレコードを表示する

• create_record - 新しいレコードを作成する

• update_record - 既存のレコードを更新する

• delete_record - レコードを削除する

開発

# Install dependencies
bun install

# Run in development mode
bun run dev

# Type check
bun run typecheck

# Run tests (builds dist first)
bun run test

# Run all checks (typecheck + tests)
bun run check

# Interactive release helper (bump, check, publish, push tag)
bun run release

# Build for production
bun run build

環境変数

ライセンス

MIT