Strapi MCP サーバー

Strapi CMSと連携するためのモデルコンテキストプロトコルサーバー。このサーバーにより、AIアシスタントは標準化されたインターフェースを介してStrapiインスタンスと連携し、コンテンツタイプとREST API操作をサポートできるようになります。

⚠️重要な免責事項：本ソフトウェアはAI技術の支援を受けて開発されています。現状のまま提供されるため、十分なテストと検証を行わない限り、本番環境で使用しないでください。コードにはエラー、セキュリティ上の脆弱性、または予期しない動作が含まれている可能性があります。研究、学習、または開発目的に限り、自己責任でご使用ください。

変更履歴

バージョン 2.3.0 - ドキュメントと設定の強化

📚 CLAUDE.md に包括的なプロジェクトドキュメントを追加しました
⚙️ より優れたバージョン検出による構成オプションの拡張
🛠️ よくある問題に対する強化されたトラブルシューティングガイド
🔄 実用的な例を交えた詳細な REST API ドキュメント
📝 コンテンツ管理のベストプラクティスガイド
🐛 異なるフォーマットパターンからのバージョン解析を修正しました
🔍 バージョン固有のガイダンスによるエラーメッセージの改善

バージョン 2.2.0 - セキュリティとバージョン処理の更新

🔒 厳格な書き込み保護ポリシーを追加しました
🔄 強化されたバージョン形式のサポート (5.*、4.1.5、v4 など)
📚 サーバー機能にドキュメントを統合
🚫 接続プロンプトを削除しました（現在は機能内にあります）
⚡ エラー処理と検証の改善
🔍 バージョン固有の差異ガイドを追加しました
📋 サーバー機能のドキュメントの強化

バージョン2.1.0

Strapi v4とv5の両方との互換性が向上
バージョン間で異なるデータ構造をサポートするために自動検証を削除しました
バージョン固有のヒントを含むエラーメッセージの強化
リクエスト処理を簡素化し、クライアントにさらなる制御権を与える
両バージョンのわかりやすい例を記載したドキュメントを更新しました

Related MCP server: Omi MCP Server

特徴

🔍 スキーマイントロスペクション
🔄 検証機能付き REST API サポート
📸 メディアアップロードの処理
🔐 JWT認証
📝 コンテンツタイプの管理
🖼️ フォーマット変換による画像処理
🌐 複数サーバーのサポート
✅ 自動スキーマ検証
🔒 書き込み保護ポリシー
📚 統合されたドキュメント
🔄 バージョン互換性管理

インストール

Claude Desktop 構成で npx を使用してこのサーバーを直接使用できます。

{ "mcpServers": { "strapi": { "command": "npx", "args": ["-y", "@bschauer/strapi-mcp-server@2.5.0"] } } }

構成

~/.mcp/strapi-mcp-server.config.jsonに設定ファイルを作成します。

{ "myserver": { "api_url": "http://localhost:1337", "api_key": "your-jwt-token-from-strapi-admin", "version": "5.*" // Optional: Specify Strapi version (e.g., "5.*", "4.1.5", "v4") } }

このファイルに複数の Strapi インスタンスを追加して構成できます。

バージョン構成

サーバーは現在、さまざまなバージョン形式をサポートしています。

ワイルドカード: 「5. 」、「4. 」
具体的: 「4.1.5」、「5.0.0」
シンプル:「v4」、「v5」

これにより、サーバーはバージョン固有のガイダンスを提供し、API の違いを適切に処理できるようになります。

JWTトークンの取得

Strapi管理パネルにログイン
適切な権限を持つAPIトークンを作成する
適切なサーバー名の下の設定ファイルにトークンを追加します

使用法

利用可能なサーバーの一覧

strapi_list_servers(); // Now includes version information and differences between v4 and v5

コンテンツタイプ

// Get all content types from a specific server strapi_get_content_types({ server: "myserver", }); // Get components with pagination strapi_get_components({ server: "myserver", page: 1, pageSize: 25, });

REST API

REST API は、組み込みの検証とバージョン固有の処理を備えた包括的な CRUD 操作を提供します。

// Query content with filters strapi_rest({ server: "myserver", endpoint: "api/articles", method: "GET", params: { filters: { title: { $contains: "search term", }, }, }, }); // Create new content strapi_rest({ server: "myserver", endpoint: "api/articles", method: "POST", body: { data: { title: "New Article", content: "Article content", category: "news", }, }, }); // Update content strapi_rest({ server: "myserver", endpoint: "api/articles/123", method: "PUT", body: { data: { title: "Updated Title", content: "Updated content", }, }, }); // Delete content strapi_rest({ server: "myserver", endpoint: "api/articles/123", method: "DELETE", });

メディアアップロード

// Upload image with automatic optimization strapi_upload_media({ server: "myserver", url: "https://example.com/image.jpg", format: "webp", quality: 80, metadata: { name: "My Image", caption: "Image Caption", alternativeText: "Alt Text", }, });

バージョンの違い（v4とv5）

サーバーが自動的に処理する Strapi バージョン間の主な違い:

v4

数値IDを使用する
ネストされた属性構造
応答内のデータラッパー
従来のRESTパターン
外部i18nプラグイン

v5

ドキュメントベースのID
フラットなデータ構造
直接属性アクセス
強化されたJWTセキュリティ
統合されたi18nサポート
新しいドキュメントサービス API

セキュリティ機能

書き込み保護ポリシー

サーバーは厳格な書き込み保護ポリシーを実装しています。

すべての書き込み操作には明示的な承認が必要です
保護される操作には次のものが含まれます。
- POST（作成）
- PUT (更新)
- 消去
- メディアアップロード
各操作はログに記録され、検証されます

ベストプラクティス

常にまずはstrapi_get_content_typesでスキーマをチェックする
エンドポイントには適切な複数形/単数形を使用する
クエリにエラー処理を含める
アップロード前にURLを検証する
最小限のクエリから始めて、必要な場合にのみ人口を追加します
更新時には常に完全なデータオブジェクトを含める
フィルターを使用してクエリのパフォーマンスを最適化する
組み込みのスキーマ検証を活用する
操作のバージョン互換性を確認する
書き込み保護ポリシーのガイドラインに従う

REST APIのヒント

フィルタリング

// Filter by field value params: { filters: { title: "Exact Match"; } } // Contains filter params: { filters: { title: { $contains: "partial"; } } } // Multiple conditions params: { filters: { $and: [{ category: "news" }, { published: true }]; } }

ソート

params: { sort: ["createdAt:desc"]; }

ページネーション

params: { pagination: { page: 1, pageSize: 25 } }

人口

// Basic request without population params: { } // Selective population when needed params: { populate: ["category"]; } // Detailed population with field selection params: { populate: { category: { fields: ["name", "slug"]; } } }

トラブルシューティング

よくある問題と解決策:

404エラー
- エンドポイントの複数形/単数形を確認する
- コンテンツタイプが存在することを確認する
- 正しいAPI URLを確認する
- 正しい ID 形式 (数値ベースとドキュメントベース) を使用しているかどうかを確認します
認証の問題
- JWTトークンが有効であることを確認する
- トークンの権限を確認する
- トークンの有効期限が切れていないことを確認する
バージョン関連の問題
- 構成内のバージョン指定を確認する
- データ構造がバージョンと一致しているかどうかを確認します
- バージョンの違いに関するドキュメントを確認する
書き込み保護エラー
- 操作が承認されていることを確認する
- 操作が保護されているかどうかを確認する
- リクエストがセキュリティポリシーに従っていることを確認する

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学

Strapi MCP Server