하찮아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에 보존.)

Related MCP server: GPT-Image-1 MCP Server

Tool: draw_shabby

프롬프트는 고정된 단일 "하찮음" 문구를 사용하며, 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 인스턴스.

개발 / 실행

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 점검 (필수)

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

소스 구조

배포 (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) 유지, 본선에서 카카오 지원 크레딧으로 도입 검토.