Skip to main content
Glama

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 사용자에게 배포되지 않습니다.

Related MCP server: Intern 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

이미지 도구가 필요할 때 동일한 명령에 세 개의 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

이미지 도구가 필요할 때 세 개의 DF_SHEET_* 환경 변수 값을 추가하세요. claude mcp list 또는 /mcp로 확인하세요.

도구

도구

효과

list_stories

Supabase 기반 Story 상태, 콘텐츠 리비전, 미리보기 경로, 문서 링크를 나열합니다.

get_story_context

식별 정보, 공식 문서 링크, 현재 콘텐츠 JSON, 리비전을 읽습니다.

get_story_rules

API를 통해 고정된 워크플로, 시맨틱, Quote, 카탈로그 또는 프로듀서 규칙을 읽습니다.

save_story_content

낙관적 리비전 보호를 사용하여 콘텐츠/레이아웃 JSON을 생성하거나 수정합니다.

validate_story

현재 Story 식별 정보와 필수 콘텐츠 배열을 검증합니다.

list_story_images

Story 슬롯과 선택적 뷰포트에 저장된 이미지를 나열합니다.

upload_story_image

최대 20MB의 로컬 PNG/JPG/WebP 파일을 업로드합니다.

update_story_image

라벨/순서를 변경하거나 파일을 안전하게 교체합니다.

delete_story_image

범위 확인 후 Story 이미지를 영구 삭제합니다.

콘텐츠 워크플로

  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 객체를 전달하세요.

Available Tools

7 tools
get_story_contextA

Read one Story identity, authoritative document receipt, current data, revision, and preview URL.

Inputs: story_id (required).

get_story_rulesA

Read one immutable Story workflow, semantic, Quote, catalog, or producer rule file.

Inputs: rule (required).

list_storiesA

List iKAOS Story IDs and their read-only delivery status.

Inputs: status.

save_story_contentA

Create or modify Story content/layout JSON with optimistic revision protection. Fixed docs and source metadata cannot be changed.

Inputs: content (required), story_id (required), expected_revision (required).

update_story_imageB

Replace an Asset Hub image file using the scoped image ID returned by upload_story_image.

Inputs: slot_id (required), image_id (required), story_id (required), image_path (required), +1 more.

upload_story_imageC

Upload a local PNG, JPG, JPEG, or WebP file to Asset Hub after verifying the Story image slot.

Inputs: slot_id (required), story_id (required), image_path (required), viewport.

validate_storyC

Validate the current Supabase Story content structure and identity.

Inputs: story_id (required), mode.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: listing vs. single-story context, reading rules vs. content, saving vs. validating, and uploading vs. updating images. Even the two image tools are clearly separated by their roles in the upload/replace workflow.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern, such as list_stories, get_story_context, save_story_content, and validate_story. No mixed casings or stylistic deviations appear.

    Tool Count5/5

    Seven tools is a well-scoped set for a story management server. Each tool covers a meaningful part of the workflow without redundancy or excessive granularity.

    Completeness4/5

    The set covers listing, reading, creating/updating content, validating, and managing images, which handles the core story lifecycle. The main gap is the absence of an explicit delete operation for stories or images, though this may be intentional given the immutable/revision-oriented design.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Read-oriented MCP server for Taranis AI, exposing the list_stories tool over stdio or Streamable HTTP for desktop AI assistants and developer tools.
      1
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Local stdio MCP server for working on Intern-hosted sites through guarded Git checkouts. It enables authentication, site preparation, testing, validation, and publishing via coding harnesses like Codex and Claude Code.
      37 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to start new Codex conversations and continue existing threads, exposing codex and codex-reply tools over stdio via the Codex app-server protocol.
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables agents and scripts to drive a social publishing account through remote or local MCP tools: drafting, scheduling, approving and publishing posts, running durable background jobs with file attachments, and reading or editing Brand Memory, assets, and standing agents. Hosts can connect over OAuth with no API key, or run the stdio variant with a key for local disk tools.
      65
      1
      MIT