mcp-ikaos-story

Codex または Claude Code を使用して iKAOS Story プロトタイプコンテンツを作成・変更するための Stdio MCP サーバーです。

この MCP は認証済みの iKAOS Story API と通信します。ユーザーが ikaos-content-studio-v2026 をクローンしたり、ローカルリポジトリのパスを設定したりする必要はありません。Story のコンテンツ/レイアウト JSON は Supabase に保存され、固定のワークフロードキュメントとソースメタデータは API の背後で読み取り専用のままです。

境界

• get_story_context は、現在のコンテンツリビジョンと信頼できる docsLink を返します。

• save_story_content は content_data のみを書き込みます。ソース、ドキュメント、Story のアイデンティティ、本番メタデータは変更できません。

• コンテンツを書き込むたびに、正確な現在のリビジョンが必要です。古い編集は、新しいコンテンツを上書きする代わりに競合を返します。

• 画像生成は対象外です。デザイナーは df-sheet ストレージを通じて、提供された画像ファイルをアップロード、置き換え、整理、削除できます。

• Supabase のサービスキーが MCP ユーザーに配布されることはありません。

インストール

npm install
npm run build

Story API を設定します:

export IKAOS_STORY_API_URL=https://your-ikaos-preview.vercel.app
export IKAOS_STORY_API_TOKEN=your-project-scoped-api-token
export IKAOS_STORY_PREVIEW_URL=https://your-ikaos-preview.vercel.app

画像ツールにはさらに次が必要です:

export DF_SHEET_URL=https://your-df-sheet.vercel.app
export DF_SHEET_PROJECT_ID=your-project-uuid
export DF_SHEET_ACCESS_TOKEN=your-df-login-review-access-token

IKAOS_STORY_PREVIEW_URL はオプションで、デフォルトは http://localhost:3000 です。DF_SHEET_ACCESS_TOKEN は現在、短命の df-login レビューアクセストークンです。トークンをコミットしないでください。

Codex

codex mcp add ikaos-story \
  --env IKAOS_STORY_API_URL=https://your-ikaos-preview.vercel.app \
  --env IKAOS_STORY_API_TOKEN=your-project-scoped-api-token \
  --env IKAOS_STORY_PREVIEW_URL=https://your-ikaos-preview.vercel.app \
  -- node /absolute/path/to/mcp-ikaos-story/dist/src/index.js

画像ツールが必要な場合は、3 つの DF_SHEET_* 環境変数を同じコマンドに追加します。codex mcp list または /mcp で確認します。

Claude Code

claude mcp add --transport stdio \
  --env IKAOS_STORY_API_URL=https://your-ikaos-preview.vercel.app \
  --env IKAOS_STORY_API_TOKEN=your-project-scoped-api-token \
  --env IKAOS_STORY_PREVIEW_URL=https://your-ikaos-preview.vercel.app \
  ikaos-story -- node /absolute/path/to/mcp-ikaos-story/dist/src/index.js

画像ツールが必要な場合は、3 つの DF_SHEET_* 環境変数を追加します。claude mcp list または /mcp で確認します。

ツール

コンテンツワークフロー

1. get_story_context を呼び出します。

2. docsLink を開き、get_story_rules で必要な固定ルールを読み取ります。

3. 返された currentData.data のコンテンツ/レイアウトオブジェクトのみを変更します。

4. 変更していない Story ID と currentData.revision を指定して save_story_content を呼び出します。Story にまだコンテンツがない場合にのみ null を使用します。

5. validate_story を呼び出し、返されたプレビュー URL を 390px と 1280px で確認します。

別のクライアントが先に保存した場合は、最新のコンテキストを取得して意図的にマージします。新しいコンテンツを確認せずに、置き換えられたリビジョンで再試行しないでください。

画像ワークフロー

1. Story コンテンツから有効な imagePromptPackages[].inputBrief.slotId を選択します。

2. ローカルの絶対画像パスを指定して upload_story_image を呼び出します。

3. 返された imageUrl を Story コンテンツで使用し、save_story_content で保存します。

4. update_story_image を呼び出してメタデータを変更するか、ファイルを置き換えます。置き換えは最初にアップロードし、アップロードが成功した後にのみ古いファイルを削除します。

5. 画像 ID を確認した後にのみ delete_story_image を呼び出します。削除すると R2 オブジェクトが削除され、この MCP では復元できません。

レスポンシブな単一ソースの場合は viewport を省略します。モバイルとデスクトップで別々のファイルを使用する場合は、リスト、更新、削除にまったく同じ viewport オブジェクトを渡します。