# 노리톡 버디 MCP Server

카카오 **Agentic Player 10 / PlayMCP in KC** 제출용 성장형 AI 캐릭터 MCP 서버입니다.

노리톡 버디는 카카오톡 안에서 대화하는 AI 캐릭터 친구입니다. 사용자의 기분, 목표, 관심사를 바탕으로 오늘의 작은 미션과 응원 메시지를 제공하고, 미션 완료에 따라 캐릭터가 함께 성장하는 Agentic 캐릭터 경험을 제공합니다.

## PlayMCP 등록 추천 정보

### MCP 이름

```text
노리톡 버디
```

### MCP 식별자

```text
noriBuddy
```

### MCP 설명

```text
노리톡 버디는 카카오톡 안에서 대화하는 성장형 AI 캐릭터 친구입니다. 사용자의 기분, 목표, 관심사를 바탕으로 오늘의 작은 미션과 응원 메시지를 제공하고, 미션 완료에 따라 캐릭터가 함께 성장합니다. 단순 대화형 챗봇이 아니라 감정 체크, 미션 생성, 캐릭터 성장 기능을 제공하는 Agentic 캐릭터 MCP입니다.
```

### 대화 예시

```text
나 오늘 좀 무기력한데 노리가 오늘 할 만한 작은 미션을 추천해줘.
```

```text
이번 주에 AI 해커톤 준비해야 하는데 노리톡 버디가 매일 도와줄 수 있어?
```

```text
오늘 미션 완료했어. 노리 캐릭터를 성장시켜주고 다음 미션을 알려줘.
```

## 제공 Tool

### 1. `talkWithCharacter`

노리 캐릭터가 사용자의 메시지에 공감하고, 오늘 할 수 있는 작은 행동을 제안합니다.

**주요 입력값**

- `message`: 사용자 메시지
- `userNickname`: 사용자 별명
- `characterName`: 캐릭터 이름. 기본값: 노리
- `mood`: 기분 상태
- `goal`: 오늘 목표
- `tone`: 응답 톤

### 2. `checkMood`

사용자의 말에서 감정 상태와 에너지 점수를 분석하고, 적합한 대화 방향을 제공합니다.

**주요 입력값**

- `message`: 기분을 담은 사용자 메시지
- `energyLevel`: 사용자가 직접 입력한 에너지 점수 0~100
- `context`: 현재 상황

### 3. `createDailyMission`

기분, 목표, 사용 가능한 시간을 바탕으로 오늘 바로 실행 가능한 작은 미션 3개를 생성합니다.

**주요 입력값**

- `mood`: 현재 기분
- `goal`: 오늘 목표
- `availableMinutes`: 사용 가능한 시간
- `intensity`: 미션 강도. `easy`, `normal`, `challenge`

### 4. `growCharacter`

완료한 미션을 바탕으로 노리 캐릭터의 성장 포인트, 레벨업 여부, 다음 미션을 반환합니다.

**주요 입력값**

- `completedMission`: 완료한 미션 내용
- `currentLevel`: 현재 캐릭터 레벨
- `currentPoints`: 현재 누적 포인트
- `streakDays`: 연속 완료 일수

## Endpoint

### Health check

```text
GET /health
```

### MCP endpoint

```text
POST /mcp
```

### 테스트용 endpoint

```text
POST /test/talkWithCharacter
POST /test/checkMood
POST /test/createDailyMission
POST /test/growCharacter
```

## 로컬 실행

```bash
npm install
npm start
```

Health check:

```bash
curl http://localhost:3000/health
```

Tool list 테스트:

```bash
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Tool call 테스트:

```bash
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"createDailyMission","arguments":{"mood":"무기력","goal":"AI 해커톤 준비","availableMinutes":10,"intensity":"easy"}}}'
```

## PlayMCP in KC Git 소스 빌드 입력값

```text
MCP 서버 이름:
nori-buddy-mcp

설명:
노리톡 버디 MCP 서버입니다. 사용자의 기분과 목표를 바탕으로 캐릭터 대화, 마음 체크, 오늘의 미션 생성, 캐릭터 성장 기능을 제공합니다.

Git URL:
https://github.com/본인계정/nori-buddy-mcp.git

브랜치 / ref:
main

Dockerfile 경로:
Dockerfile

PAT:
Public 저장소면 비워둠
```

## 접수 양식용 200자 문구

```text
노리톡 버디는 카카오톡에서 대화하는 성장형 AI 캐릭터 MCP입니다. 사용자의 기분과 목표를 바탕으로 오늘의 작은 미션과 응원을 제공하고, 미션 완료에 따라 캐릭터가 함께 성장하는 새로운 대화 경험을 만들고자 지원합니다.
```

## 개인정보 처리

- 본 샘플 서버는 사용자 정보를 저장하지 않습니다.
- 모든 추천과 성장 결과는 요청 단위로 계산됩니다.
- 실제 서비스화 시에는 이용자 동의, 데이터 보관 기간, 삭제 기능, 안전 대응 정책을 별도로 구현해야 합니다.