🚀 ペイロード CMS 3.0 MCP サーバー
📋 概要
Payload CMS 3.0 MCPサーバーは、Payload CMS開発エクスペリエンスを向上させるために設計された、専用のモデルコンテキストプロトコルサーバーです。コード検証、テンプレート生成、そしてベストプラクティスに基づいたプロジェクトスキャフォールディング機能を提供することで、開発者がより優れたPayload CMSアプリケーションを構築できるよう支援します。
✨ 特徴
🔧 ペイロードCMS 3.0の機能
検証ツール
validate
- コレクション、フィールド、グローバル、および構成のコードを検証しますquery
- クエリ検証ルールとベストプラクティスmcp_query
- ペイロードCMS構造に対してSQLのようなクエリを実行する
コード生成
generate_template
- さまざまなコンポーネントのコードテンプレートを生成するgenerate_collection
- 完全なコレクション定義を作成するgenerate_field
- 適切な型でフィールド定義を生成する
プロジェクトのセットアップ
scaffold_project
- ペイロードCMSプロジェクト構造全体を作成するvalidate_scaffold_options
- スキャフォールドオプションがベストプラクティスに従っていることを確認する(scaffold_project によって内部的に使用される)
📝 詳細なツールリファレンス
検証ツール
validate
ペイロード CMS コードの構文とベスト プラクティスを検証します。
パラメータ:
code
(文字列): 検証するコードfileType
(列挙型): ファイルのタイプ - 「collection」、「field」、「global」、または「config」
プロンプトの例:
query
Payload CMS の検証ルールとベスト プラクティスをクエリします。
パラメータ:
query
(文字列): クエリ文字列fileType
(オプションの列挙型): ファイルのタイプ - 「collection」、「field」、「global」、または「config」
プロンプトの例:
mcp_query
Payload CMS 構造に対して SQL のようなクエリを実行します。
パラメータ:
sql
(文字列): SQLのようなクエリ文字列
プロンプトの例:
コード生成
generate_template
さまざまな Payload CMS コンポーネントのコード テンプレートを生成します。
パラメータ:
templateType
(列挙型): テンプレートのタイプ - 「collection」、「field」、「global」、「config」、「access-control」、「hook」、「endpoint」、「plugin」、「block」、「migration」options
(レコード): テンプレートの設定オプション
プロンプトの例:
generate_collection
完全なペイロード CMS コレクション定義を生成します。
パラメータ:
slug
(文字列):コレクションスラッグfields
(オプション配列): フィールドオブジェクトの配列auth
(オプションのブール値): これが認証コレクションであるかどうかtimestamps
(オプションのブール値): タイムスタンプを含めるかどうかadmin
(オプションオブジェクト):管理パネルの設定hooks
(オプションのブール値):フックを含めるかどうかaccess
(オプションのブール値): アクセス制御を含めるかどうかversions
(オプションのブール値): バージョン管理を有効にするかどうか
プロンプトの例:
generate_field
ペイロード CMS フィールド定義を生成します。
パラメータ:
name
(文字列): フィールド名type
(文字列): フィールドタイプrequired
(オプションのブール値): フィールドが必須かどうかunique
(オプションのブール値):フィールドが一意であるかどうかlocalized
(オプションのブール値): フィールドをローカライズするかどうかaccess
(オプションのブール値): アクセス制御を含めるかどうかadmin
(オプションオブジェクト):管理パネルの設定validation
(オプションのブール値):検証を含めるかどうかdefaultValue
(オプション any): フィールドのデフォルト値
プロンプトの例:
プロジェクトのセットアップ
scaffold_project
完全な Payload CMS プロジェクト構造を構築します。
パラメータ:
projectName
(文字列): プロジェクトの名前description
(オプションの文字列): プロジェクトの説明serverUrl
(オプションの文字列): サーバーURLdatabase
(オプションの列挙型): データベースの種類 - 「mongodb」または「postgres」auth
(オプションのブール値): 認証を含めるかどうかadmin
(オプションオブジェクト):管理パネルの設定collections
(オプションの配列):コレクションオブジェクトの配列globals
(オプション配列): グローバルオブジェクトの配列blocks
(オプション配列):ブロックオブジェクトの配列plugins
(オプション配列): プラグイン文字列の配列typescript
(オプションのブール値): TypeScriptを使用するかどうか
プロンプトの例:
🚀 はじめに
1. 前提条件
始める前に、次のものを用意してください。
- Node.js 18+ (Payload CMS 3.0 に必要)
- 有効な鉄道アカウント
- Railway API トークン ( railway.app/account/tokensで作成)
- Payload CMS 3.0 の概念に関する基本的な知識
2. カーソルを設定する
カーソル IDE で使用するには:
- カーソル設定を開く
- MCPサーバーセクションへ移動
- 新しいMCPサーバーを追加する
- 「Payload CMS 3.0 MCP」と名付けます
- トランスポートタイプを「コマンド」に設定する
- コマンドを次のように設定します:
railway run --service=YOUR_SERVICE_ID
- 設定を保存する
3. MCPサーバーの使用
設定が完了すると、AI プロンプトで次のツールを使用できるようになります。
- コード検証: 「このペイロード CMS コレクション コードを検証する」
- テンプレート生成: 「メディアコレクションのテンプレートを生成する」
- クエリルール: 「アクセス制御のクエリ検証ルール」
- SQL のようなクエリ: 「コレクションのフィールド タイプを検索するクエリを実行する」
4. ワークフローの例
Payload CMS MCP サーバーを使用した一般的なワークフロー:
- 特定のフィールドを持つコレクションテンプレートを生成する
- 生成されたコードをベストプラクティスに従って検証する
- コードを改善するための特定の検証ルールをクエリする
- フックやエンドポイントなどの追加コンポーネントを生成する
- 準備ができたら完全なプロジェクト構造を構築する
5. 完全なワークフローの例
会話で MCP サーバーを使用する方法の完全な例を次に示します。
ユーザー: このコードがベストプラクティスに従っているかどうか検証できますか?
AI: コードを検証します。
[検証ツールを使用]
検証結果によると、コードは有効であり、ベストプラクティスに準拠しています。以下にいくつか提案があります。
- 深いクエリを防ぐために、カテゴリ関係フィールドにmaxDepthを追加することを検討してください。
- 作成、更新、削除操作にアクセス制御を追加したい場合があります
- 製品が更新されたときに在庫管理用のフックを追加することを検討してください
ユーザー: Payload CMS におけるアクセス制御のベストプラクティスは何ですか?
AI: アクセス制御の検証ルールを照会してみましょう。
[クエリツールを使用]
Payload CMS でのアクセス制御のベスト プラクティスは次のとおりです。
- 作成、読み取り、更新、削除の各操作に対して、明示的なアクセス制御関数を常に定義します。
- 管理者ユーザーに対してロールベースのアクセス制御を使用する
- 機密データに対するフィールドレベルのアクセス制御を実装する
- 幅広い権限に対してコレクションレベルのアクセス制御を使用する
- 複雑なロジックの場合は、アクセス制御と併せてフックを使用することを検討してください。
ユーザー: ここで、この製品コレクションとカテゴリ コレクションを使用して完全なプロジェクトをスキャフォールディングする必要があります。
AI: 完全なプロジェクトをスキャフォールディングします。
[scaffold_projectツールを使用]
次のような完全な Payload CMS プロジェクト構造を生成しました。
- ご指定の商品コレクション
- 名前と説明フィールドを持つカテゴリコレクション
- 製品画像のメディアコレクション
- 管理者ユーザーの認証
- TypeScriptの設定
- MongoDBデータベースのセットアップ
- 必要なすべてのファイルと設定
プロジェクトは、 npm install
およびnpm run dev
で初期化する準備が整いました。
📋 スキャフォールディングの例と詳細なプロンプト
プロジェクトの足場の例
MCPサーバーを使用してプロジェクトをスキャフォールディングすると、完全なプロジェクト構造が得られます。スキャフォールディングされたeコマースプロジェクトは次のようになります。
スキャフォールディングプロジェクトプロンプトの例(基本)
Scaffold プロジェクト プロンプトの例 (詳細)
コレクション作成プロンプトの例(基本)
コレクション作成プロンプトの例(詳細)
プロンプトの詳細レベル
MCP サーバーは、さまざまな詳細レベルのプロンプトを処理できます。
最小限の詳細(AIがギャップを埋めます)
中程度の詳細(特定の要件)
ハイディテール(完全仕様)
効果的なプロンプトのヒント
- 要件を具体的に指定します。詳細を多く指定するほど、出力はよりカスタマイズされたものになります。
- 関係を指定する: コレクションが互いにどのように関連しているかを明確に示します。
- 検証のニーズを含める: フィールドの検証ルールまたは制約をすべて記載します。
- 管理 UI の設定を記述: 管理パネルでコレクションをどのように表示するかを指定します。
- フックとアクセス制御について言及する: 特定のビジネス ロジックまたはセキュリティ ルールが必要な場合は、プロンプトにそれらを含めます。
- ドメイン固有の用語を使用する: 業界やユースケースに関連する用語を使用してプロジェクトを説明します。
📄 ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
🌍 MATMAX WORLDWIDEについて
私たちは、人間性を尊重しながら生活を豊かにするツールである、善のためのテクノロジーを信じています。
テクノロジーが健康、つながり、そして人生の目的に役立つ未来を共に築きましょう。共に、私たち一人ひとりの最高の部分を引き出すデジタル体験を創造しましょう。
人間中心のテクノロジーに関する当社のビジョンの詳細については、 matmax.worldをご覧ください。
🖥️ ローカルで実行
npm を使用して Payload CMS MCP サーバーをローカルで実行できます。
オプション1: npmからインストールする
オプション2: リポジトリをクローンする
- リポジトリをクローンします。
- 依存関係をインストールします:
- サーバーをローカルで実行します。
あるいは、次のようにも言えます。
MCP サーバーはローカルで実行され、Railway API トークンを必要とせずに開発およびテストのためにアクセスできるようになります。
🚀 展開オプション
鉄道への展開(推奨)
MCP サーバーを展開する最も簡単な方法は、Railway のワンクリック展開を使用することです。
ボタンをクリックした後:
- 「GitHubリポジトリからデプロイ」を選択します
- 「Matmax-Worldwide/payloadcmsmcp」を検索
- 「今すぐデプロイ」をクリック
クイックカーソルIDEセットアップ
展開後:
- Railway CLI をインストールします:
npm install -g @railway/cli
- 鉄道へのログイン:
railway login
- プロジェクトへのリンク:
railway link
- カーソル設定 > MCP サーバーで、コマンドを「
railway run
に設定します。
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
自然言語コマンドによる Payload CMS プロジェクトの管理を可能にし、開発者が会話型 AI を使用してコンテンツ モデルを作成、構成、展開できるようにします。
- 📋 概要
- ✨ 特徴
- 🔧 ペイロードCMS 3.0の機能
- 📝 詳細なツールリファレンス
- 📋 スキャフォールディングの例と詳細なプロンプト
- 📄 ライセンス
- 🌍 MATMAX WORLDWIDEについて
- 🖥️ ローカルで実行
- 🚀 展開オプション
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityProvides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.Last updated -54TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -605MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.Last updated -852TypeScript
- -securityFlicense-qualityEnables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.Last updated -JavaScript