Misterboe Strapi MCP Server

🚀 Strapi MCP サーバー

Strapi の MCP（モデルコンテキストプロトコル）サーバーは、AI アシスタントが標準化されたインターフェースを通じて Strapi インスタンスとやり取りできるようにし、コンテンツタイプと REST API 操作をサポートします。

🚀 クイックスタート

このセクションでは、Strapi MCP サーバーのインストールと初期設定について説明します。

📦 インストール

Claude Desktop の設定で、npx を使って以下のコマンドを実行してサーバーをインストールします。

npx strapi-mcp-server

設定ファイルの作成

設定ファイル ~/.mcp/strapi-mcp-server.config.json を作成または編集し、以下の内容を追加します。

{
  "apiUrl": "http://localhost:1337", // Strapi インスタンスの URL。デフォルトは http://localhost:1337
  "version": "v5",                 // サポートされる Strapi のバージョン。選択肢: v4, v5
  "jwtToken": "your_jwt_token"     // Strapi の JWT 認証トークン
}

✨ 主な機能

核心機能

1. コンテンツのクエリ：

   • 単一または複数のコンテンツエントリを取得します。
   • フィルタリング、ソート、およびページングをサポートします。

2. メディアのアップロード：

   • 画像やその他のファイルをアップロードします。
   • 自動的に形式変換と最適化（WebP など）を行います。
   • カスタムメタデータをサポートします。

3. バージョンサポート：

   • Strapi v4 と v5 の異なる API 構造とデータ形式をサポートします。

💻 使用例

基本的な使用法

コンテンツのクエリ

// 単一の記事を取得
strapi_get_content({
  server: "default",
  endpoint: "articles",
  id: "123"
});

// 複数の記事を取得してページング
strapi_get_content({
  server: "default",
  endpoint: "articles",
  params: {
    pagination: { page: 1, pageSize: 25 },
    sort: ["createdAt:desc"]
  }
});

メディアのアップロード

// 画像をアップロードして最適化
strapi_upload_media({
  server: "default",
  url: "https://example.com/image.jpg",
  format: "webp",
  quality: 80,
  metadata: {
    name: "My Image",
    caption: "Image Caption",
    alternativeText: "Alt Text"
  }
});

📚 ドキュメント

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

v4

• 数字 ID を使用します。
• 属性構造がネストされています。
• レスポンスデータは data ラッパーに含まれています。
• 従来の REST モードです。
• 外部の i18n プラグインを使用します。

v5

• ドキュメント ID を使用します。
• データ構造が扁平化されています。
• 属性に直接アクセスできます。
• 強化された JWT セキュリティです。
• 統合された i18n サポートがあります。
• 新しいドキュメントサービス API があります。

セキュリティ機能

書き込み保護ポリシー

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

• すべての書き込み操作（POST、PUT、DELETE）には明示的な承認が必要です。
• 保護されている操作には以下が含まれます。
  • 作成（POST）
  • 更新（PUT）
  • 削除（DELETE）
  • メディアのアップロード
• 各操作はログに記録され、検証されます。

ベストプラクティス

1. コンテンツタイプを確認する：strapi_get_content_types を使用してフィールドと構造を確認します。
2. URL 形式を正しく使用する：複数形と単数形のエンドポイントを区別します。
3. エラー処理メカニズムを含める：各リクエストに例外キャッチを追加します。
4. 適切な権限を設定する：ロールと権限に基づいて API アクセスを制御します。

トラブルシューティング

一般的な問題

1. 401 未認証エラー：

   • JWT トークンが正しく設定されていることを確認します。
   • トークンが Strapi インスタンスで有効になっていることを確認します。

2. 404 リソースが見つからない：

   • エンドポイント名と ID が正しいことを確認します。
   • Strapi インスタンスの API エンドポイントが正しく設定されていることを確認します。

3. データ形式エラー：

   • リクエストパラメータがターゲットバージョン（v4 または v5）と一致していることを確認します。
   • 渡されるデータ構造が要件を満たしていることを確認します。

貢献ガイド

コミュニティの貢献を歓迎します！Pull Request を提出してプロジェクトを改善してください。

• 問題の提出：GitHub Issues
• 機能または修正の提出：Pull Request