高度な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_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
貢献
- リポジトリをフォークする
- 機能ブランチを作成する
- 変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する