Kangjun Story MCP

소설 작성 프로젝트 룰을 기반으로 한 Model Context Protocol(MCP) 서버입니다. 시나리오 진행 시 캐릭터 프로필 생성 및 RPG 장비 아이템(무기/방어구/헬멧/글로브/부츠/벨트/링/아뮬렛 등) 생성을 지원하며, 아이템 등급은 커먼/매직/레어/유니크/에픽/레전드/미스틱 7단계를 따릅니다.

기능

• scaffold_project: '소설책' 폴더 스캐폴딩 및 템플릿(.cursorrules, 템플릿 파일) 배치
• create_character_profile: 캐릭터 템플릿 채워진 마크다운 생성(파일 저장 옵션)
• generate_equipment_item: 장비 아이템 JSON/마크다운 생성(파일 저장 옵션)
• list_rarities: 등급 목록 제공
• generate_worldbuilding: 스토리/세계관 시드 + 작품개요/스타일가이드/세계관규칙/타임라인/메인플롯 자동 생성
• generate_story_outline: 구조 모델(three_act/save_the_cat/heros_journey/seven_point) 기반 장별/씬별 아웃라인 생성
• resume_progress: 분량/투두 기준으로 다음 작업 자동 판별, 필요한 파일/프롬프트 생성 및 NEXT_ACTION.json 출력

설치

1. 의존성 설치

   npm install

2. 빌드

   npm run build

3. 실행(표준 입출력)

   npm start

MCP 클라이언트 설정 예시

• Claude Desktop (설정 파일 예):

  { "mcpServers": { "kangjun-story-mcp": { "command": "node", "args": ["/absolute/path/to/kangjun-story-mcp/dist/index.js"] } } }

• Cursor/기타 MCP 호환 클라이언트도 유사하게 표준입출력 서버로 등록하면 됩니다.

도구 입력 스키마

• scaffold_project

  • rootDir: string (필수)
  • folderName: string (기본값: "소설책")
  • overwrite: boolean (기본값: false)

• create_character_profile

  • name: string (필수)
  • age, gender, role, firstAppearance: string (선택)
  • pov: boolean (선택, 기본 false)
  • outputPath: string (선택, 지정 시 파일 저장)
  • overwrite: boolean (기본값 false)

• generate_equipment_item

  • slot: "weapon|helmet|chest|gloves|boots|belt|ring|amulet|shield|pants"
  • rarity: "커먼|매직|레어|유니크|에픽|레전드|미스틱"
  • level: number (기본 1)
  • seed: number (기본 1337)
  • name: string (선택, 커스텀 이름)
  • writeFile: boolean (선택, 기본 false)
  • outputDir: string (선택, 파일 저장 경로)
  • overwrite: boolean (기본 false)

• generate_worldbuilding

  • rootDir: string (필수), folderName: string("소설책")
  • title, author, genres(string|array), tone, worldName, magicLevel, techLevel
  • targetWords(number), startDate, deadline, tags(string|array)
  • model("three_act" 등), chapters(number), scenesPerChapter(number), seed(number), overwrite(boolean)

• generate_story_outline

  • rootDir: string (필수), folderName: string("소설책")
  • model: "three_act"|"save_the_cat"|"heros_journey"|"seven_point"
  • chapters(number), scenesPerChapter(number), seed(number), overwrite(boolean)

• resume_progress

  • rootDir: string (필수), folderName: string("소설책")
  • volume?: number(1–15)
  • targetMinChars: number = 10000
  • createScenePrompts: boolean = true
  • dryRun: boolean = false
  • 반환: summary JSON(targetVolume, manuscriptPath, currentChars, needExpansion, outlinePath, scenePromptsPath, generated[], nextInstruction)

생성되는 폴더/파일(예)

• 소설책/
  • .cursorrules/
    • cursorrules.md
    • novel-brain.json
  • 00-핵심관리/
    • dashboard.md
  • 01-세계관/고유명사사전/
  • 02-캐릭터/
    • 캐릭터-템플릿.md
    • 주인공/
    • 조연/
    • 엑스트라/
  • 03-플롯/
    • scene-checklist.md
  • 04-원고/[권번호]/(챕터|버전관리|삭제된씬)/
  • 05-심리추적/(감정추적|동기맵)/
    • emotion-graph-template.md
  • 10-시각자료/이미지프롬프트/prompt-template.md
  • 11-템플릿/creative-prompts.md

라이선스

• 내부 프로젝트 용도. 필요 시 저작권/라이선스 문구를 추가하세요.