# 하찮아MCP 🎨

> 카카오 AGENTIC PLAYER 10 공모전 출품작
> ChatGPT는 잘 그립니다. **하찮아MCP는 일부러 못 그립니다.** 그리고 사람들은 못 그린 걸 더 좋아합니다.

카카오톡 대화창에서 "고양이 그려줘"라고 하면, 잘 그린 그림 대신 **선 몇 개로 대충 그린 하찮은 그림**을 돌려주는 MCP 서버입니다.

## 동작 흐름

```
사용자(카카오톡) → ChatGPT for Kakao(오케스트레이터) → 하찮아MCP
   draw_shabby: 1) 안전 필터 → 2) 하찮음 프롬프트 변환
              → 3) "이 프롬프트로, 다듬지 말고 그대로 그려라" 지시 + 프롬프트 반환
                 → 호스트 ChatGPT가 실제 이미지를 렌더링
```

- **실제 렌더링은 호스트 ChatGPT가 담당**한다. 지시 따르기가 강한 모델이라 하찮음 화풍이 잘 나오고, 우리 비용은 0원.
- MCP의 가치 = **안전필터 + 한글주제→영문 하찮음 프롬프트 설계 + 일관된 화풍 지시**.
- 제어 흐름은 ChatGPT→MCP→반환 **일방향**. MCP가 ChatGPT를 거꾸로 호출하지 않는다(주객전도 없음).
- (Pollinations 직접 생성은 **본선/폴백 옵션**으로 `src/pollinations.ts`에 보존.)

## Tool: `draw_shabby`

| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| `subject` | string | O | 그릴 대상. 예: "고양이", "출근하는 직장인" |
| `mood` | string | X | 분위기/감정. 예: "슬픈", "신난" |

프롬프트는 고정된 단일 "하찮음" 문구를 사용하며, `subject`(+`mood`)만 치환된다. (`src/shabby.ts`)

**반환**: `content`에 렌더링 지시 텍스트("이 프롬프트로, 다듬지 말고 그대로 그려라" + IMAGE PROMPT),
`structuredContent`에 `render_prompt` / `subject` / `mood` / `render_rules`. 실제 이미지는 호스트 ChatGPT가 생성한다.
안전성 위반 시에는 그림 대신 친절한 거부 메시지를 반환한다.

## 전송 방식 (PlayMCP 준수)

- **Streamable HTTP (stateless)**. 엔드포인트 `POST /mcp`, 헬스체크 `GET /healthz`.
- 포트는 `PORT` 환경변수(기본 3000). Remote(공개 URL) MCP 서버로 배포.
- 세션 없음 → 요청마다 새 server/transport 인스턴스.

## 개발 / 실행

```bash
npm install
npm run build

npm start                  # Streamable HTTP MCP 서버 기동 (http://localhost:3000/mcp)
node dist/test-client.js   # HTTP로 서버 띄워 핸드셰이크 + tools/call 검증
npm run smoke              # 프롬프트 변환 로직 + (폴백)Pollinations 호출 검증
```

### MCP Inspector 점검 (필수)

```bash
npm start                                  # 한 터미널에서 서버 기동
npx @modelcontextprotocol/inspector        # 다른 터미널에서 Inspector 실행
#  → Transport: "Streamable HTTP", URL: http://localhost:3000/mcp 로 연결
```

## 소스 구조

| 파일 | 역할 |
|---|---|
| `src/index.ts` | Streamable HTTP(stateless) 진입점 (Node 내장 http) |
| `src/server.ts` | MCP 서버 + `draw_shabby` 툴 정의(annotations 포함) |
| `src/shabby.ts` | 하찮음 프롬프트(고정 문구 + subject/mood 치환) — 핵심 경쟁력 |
| `src/safety.ts` | 입력 안전 필터(한/영 금지어 + 우회 정규화) |
| `src/pollinations.ts` | (폴백) Pollinations URL 조립 + 재시도 + base64 변환 |
| `Dockerfile` | PlayMCP in KC 컨테이너 배포용(멀티스테이지) |

## 배포 (PlayMCP in KC → PlayMCP 등록)

1. **PlayMCP in KC**: Git 소스 또는 컨테이너 이미지(`Dockerfile`)로 배포 → **Endpoint URL** 발급.
2. **PlayMCP 등록**: Endpoint 입력 → "정보 불러오기" 성공 → **"임시 등록"**(아직 심사요청 X) → 도구함 추가 → **AI채팅 테스트**.
3. 테스트 OK → "심사 요청"(1~2일, 최대 7일) → 승인 → **"전체 공개"** → 상세페이지 URL 복사.
4. 공모전 페이지 "Player 예선 참여" 비즈폼 접수(최대 2개, **7/14 마감, 7/7 제출 권장**).

### 남은 확인사항

- [ ] **(리스크)** PlayMCP **AI채팅 테스트**에서 호스트가 ① 프롬프트로 이미지를 생성하고 ② "다듬지 마" 지시를 따르는지 실측 → 안 되면 Pollinations 직접 생성(폴백)으로 전환.
- [ ] 데모 시나리오 정리(제출용).

## 본선 TODO (예선 이후)

- [ ] **사진 → 사진 (image-to-image)**: 사용자가 첨부한 사진을 하찮게 redraw. Pollinations `kontext`/`nanobanana` 모델 필요 — `enter.pollinations.ai` 가입 + API 토큰 + Pollen 크레딧 소모(유료, 단 매우 저렴/일일 무료 grant 있음). 입력 이미지는 공개 URL이어야 함(파일 업로드 X). 예선은 무료·무제한 text→image(Flux) 유지, 본선에서 카카오 지원 크레딧으로 도입 검토.