高度なPocketBase MCPサーバー
PocketBaseデータベースと連携するための高度なツールを提供する包括的なMCPサーバーです。このサーバーは、モデルコンテキストプロトコル（MCP）を通じて、高度なデータベース操作、スキーマ管理、データ操作を可能にします。
特徴
コレクション管理
カスタムスキーマを使用してコレクションを作成および管理する
データ保存を伴うコレクションスキーマの移行
高度なインデックス管理（作成、削除、一覧表示）
スキーマ検証と型安全性
コレクションスキーマとメタデータを取得する
レコード操作
レコードのCRUD操作
フィルタリング、並べ替え、集計による高度なクエリ
バッチインポート/エクスポート機能
関係拡大サポート
ページネーションとカーソルベースのナビゲーション
ユーザー管理
ユーザー認証とトークン管理
ユーザーアカウントの作成と管理
パスワード管理
ロールベースのアクセス制御
セッション処理
データベース操作
データベースのバックアップと復元
複数のエクスポート形式（JSON/CSV）
データ移行ツール
インデックスの最適化
バッチ操作
Related MCP server: PocketBase MCP Server
利用可能なツール
コレクション管理
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 buildPocketBaseインスタンスを起動する
MCPサーバーはPocketBaseインスタンスに自動的に接続します
Smithery経由でインストール
Smithery経由で Claude Desktop 用の PocketBase Server を自動的にインストールするには:
npx -y @smithery/cli install pocketbase-server --client claude貢献
リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.