高度なPocketBase MCPサーバー

PocketBaseデータベースと連携するための高度なツールを提供する包括的なMCPサーバーです。このサーバーは、モデルコンテキストプロトコル（MCP）を通じて、高度なデータベース操作、スキーマ管理、データ操作を可能にします。

特徴

コレクション管理

カスタムスキーマを使用してコレクションを作成および管理する
データ保存を伴うコレクションスキーマの移行
高度なインデックス管理（作成、削除、一覧表示）
スキーマ検証と型安全性
コレクションスキーマとメタデータを取得する

レコード操作

レコードのCRUD操作
フィルタリング、並べ替え、集計による高度なクエリ
バッチインポート/エクスポート機能
関係拡大サポート
ページネーションとカーソルベースのナビゲーション

ユーザー管理

ユーザー認証とトークン管理
ユーザーアカウントの作成と管理
パスワード管理
ロールベースのアクセス制御
セッション処理

データベース操作

データベースのバックアップと復元
複数のエクスポート形式（JSON/CSV）
データ移行ツール
インデックスの最適化
バッチ操作

利用可能なツール

コレクション管理

create_collection : カスタムスキーマで新しいコレクションを作成する
get_collection_schema : コレクションのスキーマの詳細を取得する
migrate_collection : データを保持したままコレクションスキーマを移行する
manage_indexes : コレクションインデックスを作成、削除、または一覧表示する

レコード操作

create_record : コレクションに新しいレコードを作成する
list_records : オプションのフィルターとページ区切りを使用してレコードを一覧表示します
update_record : 既存のレコードを更新する
delete_record : レコードを削除する
query_collection : フィルタリング、並べ替え、集計機能を備えた高度なクエリ
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）でデータをインポートします

構成

サーバーには次の環境変数が必要です。

POCKETBASE_URL : PocketBaseインスタンスのURL（例：" http://127.0.0.1:8090 "）

オプションの環境変数:

POCKETBASE_ADMIN_EMAIL : 特定の操作の管理者メールアドレス
POCKETBASE_ADMIN_PASSWORD : 管理者パスワード
POCKETBASE_DATA_DIR : カスタムデータディレクトリパス

使用例

コレクション管理

// Create a new collection
await mcp.use_tool("pocketbase", "create_collection", {
  name: "posts",
  schema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    }
  ]
});

// Manage indexes
await mcp.use_tool("pocketbase", "manage_indexes", {
  collection: "posts",
  action: "create",
  index: {
    name: "title_idx",
    fields: ["title"],
    unique: true
  }
});

高度なクエリ

// Query with filtering, sorting, and aggregation
await mcp.use_tool("pocketbase", "query_collection", {
  collection: "posts",
  filter: "created >= '2024-01-01'",
  sort: "-created",
  aggregate: {
    totalLikes: "sum(likes)",
    avgRating: "avg(rating)"
  },
  expand: "author,categories"
});

データのインポート/エクスポート

// Import data with upsert mode
await mcp.use_tool("pocketbase", "import_data", {
  collection: "posts",
  data: [
    {
      title: "First Post",
      content: "Hello World"
    },
    {
      title: "Second Post",
      content: "More content"
    }
  ],
  mode: "upsert"
});

// Backup database
await mcp.use_tool("pocketbase", "backup_database", {
  format: "json" // or "csv"
});

スキーマの移行

// Migrate collection schema
await mcp.use_tool("pocketbase", "migrate_collection", {
  collection: "posts",
  newSchema: [
    {
      name: "title",
      type: "text",
      required: true
    },
    {
      name: "content",
      type: "text",
      required: true
    },
    {
      name: "tags",
      type: "json",
      required: false
    }
  ],
  dataTransforms: {
    // Optional field transformations during migration
    tags: "JSON.parse(oldTags)"
  }
});

認証方法

// List available authentication methods
await mcp.use_tool("pocketbase", "list_auth_methods", {
  collection: "users"
});

// Authenticate with password
await mcp.use_tool("pocketbase", "authenticate_user", {
  email: "user@example.com",
  password: "securepassword",
  collection: "users"
});

// Authenticate with OAuth2
await mcp.use_tool("pocketbase", "authenticate_with_oauth2", {
  provider: "google",
  code: "auth_code_from_provider",
  codeVerifier: "code_verifier_from_pkce",
  redirectUrl: "https://your-app.com/auth/callback",
  collection: "users"
});

// Request password reset
await mcp.use_tool("pocketbase", "request_password_reset", {
  email: "user@example.com",
  collection: "users"
});

// Confirm password reset
await mcp.use_tool("pocketbase", "confirm_password_reset", {
  token: "verification_token",
  password: "new_password",
  passwordConfirm: "new_password",
  collection: "users"
});

// Refresh authentication token
await mcp.use_tool("pocketbase", "auth_refresh", {
  collection: "users"
});

エラー処理

すべてのツールには、詳細なエラーメッセージを含む包括的なエラー処理機能が搭載されています。エラーは適切に入力され、以下のエラーが含まれます。

無効なリクエストエラー
認証エラー
データベース操作エラー
スキーマ検証エラー
ネットワークエラー

型安全性

サーバーにはすべての操作に対するTypeScript定義が含まれており、ツール使用時の型安全性が確保されています。各ツールの入力スキーマは厳密に型指定され、検証されます。

ベストプラクティス

常にtry/catchブロックで適切なエラー処理を使用する
操作を実行する前にデータを検証する
クエリパフォーマンスを向上させるために適切なインデックスを使用する
データベースを定期的にバックアップする
スキーマの変更には移行を使用する
ユーザー管理に関するセキュリティのベストプラクティスに従う
データベースのパフォーマンスを監視および最適化する

発達

リポジトリをクローンする
依存関係をインストール: npm install
.env.exampleを.envにコピーして設定する
ビルド: npm run build
PocketBaseインスタンスを起動する
MCPサーバーはPocketBaseインスタンスに自動的に接続します

Smithery経由でインストール

Smithery経由で Claude Desktop 用の PocketBase Server を自動的にインストールするには:

npx -y @smithery/cli install pocketbase-server --client claude

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

PocketBase MCP Server

Integrations

高度なPocketBase MCPサーバー

特徴

コレクション管理

レコード操作

ユーザー管理

データベース操作

利用可能なツール

コレクション管理

レコード操作

ユーザー管理

データベース操作

構成

使用例

コレクション管理

高度なクエリ

データのインポート/エクスポート

スキーマの移行

認証方法

エラー処理

型安全性

ベストプラクティス

発達

Smithery経由でインストール

貢献