lovinx-mcp-server by rapina - MCP Server

Lovinx MCP Server

남성향 로맨스 판타지 게임 시나리오 생성을 위한 Model Context Protocol (MCP) 서버입니다.

기능

이 MCP 서버는 세 가지 주요 기능을 제공합니다:

시나리오 생성: 사용자의 입력(시나리오 설정, 히로인 설정)과 시나리오 생성 프롬프트 템플릿을 결합하여 AI가 실행할 수 있는 완전한 프롬프트를 생성합니다.
히로인 이미지 프롬프트 생성: 히로인 정보를 바탕으로 Midjourney에 최적화된 text-to-image 프롬프트를 생성합니다. 일관된 캐릭터 생성을 위한 기본 프롬프트와 다양한 표정/포즈의 변형 프롬프트를 제공합니다.
비디오 프롬프트 생성: 완성된 시나리오의 특정 씬에 대해 각 videoClip의 시작/종료 프레임을 위한 text-to-image 프롬프트를 생성합니다.

설치

npm install
npm run build

사용 방법

MCP 클라이언트 설정

Claude Desktop이나 다른 MCP 클라이언트의 설정 파일에 다음과 같이 추가하세요:

{
  "mcpServers": {
    "lovinx-scenario": {
      "command": "node",
      "args": ["C:\\work\\lovinx-mcp-server\\build\\index.js"]
    }
  }
}

제공되는 도구

`generate_scenario_prompt`

남성향 로맨스 판타지 게임 시나리오 생성을 위한 완전한 프롬프트를 생성합니다.

입력 파라미터:

scenarioSetting (필수): 시나리오 설정 (배경, 컨셉, 상황)
- 예: "지하철에서 우연히 만난 두 사람의 이야기"
heroineSetting (필수): 히로인 설정 (이름, 나이, 외모, 성격, 직업 등)
- 예: "이름: 지우, 나이: 27세, 직업: IT 회사 디자이너, 성격: 쿨하지만 외로움"
totalScenes (선택): 생성할 씬의 개수 (기본값: 7)

출력:

사용자 입력과 프롬프트 템플릿이 결합된 완전한 프롬프트를 반환합니다. 이 프롬프트를 AI에게 전달하면 JSON 형식의 시나리오가 생성됩니다.

`generate_heroine_image_prompt`

히로인 캐릭터의 외모 정보를 받아 Midjourney에 최적화된 간결하고 매력적인 text-to-image 프롬프트를 생성합니다.

입력 파라미터:

heroine (필수): 히로인 정보 객체 (시나리오의 scenarioPlan.heroine)
- name, age, occupation, appearance, personality 등 포함

출력:

히로인 이미지 프롬프트 가이드와 입력 데이터가 결합된 프롬프트를 반환합니다. 이 프롬프트를 AI에게 전달하면:

실사 3중 보장 Midjourney 프롬프트 (photorealistic + professional photography + cinematic quality로 카툰 방지)
핵심 특징만 압축: 컨셉, 아키타입, 인종, 나이, 헤어, 패션, 매력 포인트 1개
조명 스타일로 분위기 표현
9:16 세로 비율 (Instagram/Shorts 최적화)
Midjourney 파라미터 포함 (--ar 9:16 --style raw --v 6)

왜 간결한가? 상세한 묘사는 오히려 현실적이 되어 매력이 감소합니다. 간결한 프롬프트가 더 이상적이고 매력적인 실사 히로인을 생성합니다.

왜 3중 보장인가? 카툰으로 생성되는 것을 방지하기 위해 photorealistic, professional photography, cinematic quality 3가지 키워드를 함께 사용합니다.

이 프롬프트로 생성된 단일 레퍼런스 이미지를 --cref로 사용하여 모든 씬에서 일관된 캐릭터를 유지할 수 있습니다.

`generate_video_prompts`

완성된 시나리오의 특정 씬에 대해 모든 videoClip의 시작/종료 프레임을 위한 text-to-image 프롬프트를 생성합니다.

입력 파라미터:

scenarioPlan (필수): 시나리오 플랜 객체 (전체 시나리오의 scenarioPlan)
- 히로인 정보, 플레이어 정보, 전체 컨셉 등이 포함됨
scene (필수): 비디오 프롬프트를 생성할 특정 씬 객체
- id, location, timeOfDay, dialogues 등 포함
sceneNumber (필수): 씬 번호 (예: 1, 2, 3...)

출력:

비디오 프롬프트 생성 가이드와 입력 데이터가 결합된 프롬프트를 반환합니다. 이 프롬프트를 AI에게 전달하면:

dialogues 순서대로 START/END 프롬프트 리스트 (JSON 형식 없음)
각 dialogue의 시작 프레임과 종료 프레임 text-to-image 프롬프트
choice 타입의 각 선택지에 대한 START/END 프롬프트
일관된 히로인 외모 유지
자연스러운 프레임 전환

프로젝트 구조

lovinx-mcp-server/
├── src/
│   └── index.ts                      # MCP 서버 메인 코드
├── prompts/
│   ├── scenario-generation-full.md   # 시나리오 생성 프롬프트 템플릿
│   ├── heroine-image-prompt.md       # 히로인 이미지 프롬프트 생성 가이드
│   └── video-prompt-generation.md    # 비디오 프롬프트 생성 가이드
├── build/                            # TypeScript 컴파일 결과
├── package.json
└── tsconfig.json

개발

# 빌드
npm run build

# 개발 모드 (빌드 + 실행)
npm run dev

라이선스

ISC