mcp-ikaos-story

Stdio MCP-сервер для создания и изменения контента прототипа iKAOS Story с помощью Codex или Claude Code.

MCP взаимодействует с аутентифицированным API iKAOS Story. Пользователям не нужно клонировать ikaos-content-studio-v2026 или настраивать локальный путь к репозиторию. JSON контента/макета Story хранится в Supabase, а фиксированные документы рабочего процесса и метаданные источника остаются доступными только для чтения через API.

Границы

• get_story_context возвращает текущую ревизию контента и авторитетный docsLink.

• save_story_content записывает только content_data; источник, документы, идентичность Story и производственные метаданные изменить нельзя.

• Каждая запись контента требует точной текущей ревизии. Устаревшее изменение возвращает конфликт вместо перезаписи более нового контента.

• Генерация изображений вне области действия. Дизайнеры могут загружать, заменять, организовывать и удалять предоставленные файлы изображений через хранилище df-sheet.

• Ключ сервиса Supabase не распространяется среди пользователей MCP.

Установка

npm install
npm run build

Настройте API Story:

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

Добавьте три значения env 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

Добавьте три значения env DF_SHEET_*, когда нужны инструменты для работы с изображениями. Проверьте с помощью claude mcp list или /mcp.

Инструменты

Рабочий процесс с контентом

1. Вызовите get_story_context.

2. Откройте docsLink и прочитайте необходимые фиксированные правила с помощью get_story_rules.

3. Изменяйте только возвращаемый объект контента/макета currentData.data.

4. Вызовите save_story_content с неизменённым ID Story и currentData.revision. Используйте null только когда у Story ещё нет контента.

5. Вызовите validate_story, затем проверьте возвращённый URL предпросмотра при 390px и 1280px.

Если другой клиент сохранил раньше, получите последний контекст и осознанно выполните слияние. Не повторяйте попытку с заменённой ревизией без просмотра более нового контента.

Рабочий процесс с изображениями

1. Выберите допустимый imagePromptPackages[].inputBrief.slotId из контента Story.

2. Вызовите upload_story_image с абсолютным локальным путём к изображению.

3. Используйте возвращённый imageUrl в контенте Story и сохраните его с помощью save_story_content.

4. Вызовите update_story_image для изменения метаданных или замены файла. Замена сначала загружает новый файл и удаляет старый только после успешной загрузки.

5. Вызывайте delete_story_image только после подтверждения ID изображения. Удаление убирает объект R2, и он не может быть восстановлен этим MCP.

Опустите viewport для одного адаптивного источника. Передавайте точно такой же объект viewport в list, update и delete при использовании отдельных файлов для мобильной или десктопной версии.