kangjun-story-mcp/README.md

Kangjun Story MCP: Novel writing assistant MCP server with character and RPG equipment tools

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

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