KakaoTalk Emoticons

카카오 이모티콘 PlayMCP 서버

카카오톡 이모티콘 제작을 자동화하거나 제작에 도움을 주기 위한 MCP (Model Context Protocol) 서버입니다.

기능

1. before-preview (이모티콘 기획 프리뷰)

• 이모티콘 제작 전 기획 단계에서 사용
• 카카오톡 채팅방 스타일의 프리뷰 페이지 생성
• 각 이모티콘 위치에 설명 텍스트 표시

2. generate (이모티콘 생성)

• Hugging Face API를 사용한 AI 이모티콘 생성
• 캐릭터 이미지 기반 이모티콘 제작
• 캐릭터 이미지가 없으면 자동 생성
• 움직이는 이모티콘은 비디오 생성 후 WebP 변환

3. after-preview (완성본 프리뷰)

• 실제 이모티콘 이미지가 포함된 프리뷰 페이지
• ZIP 파일 다운로드 기능
• 이모티콘 클릭 시 확대 보기

4. check (이모티콘 검사)

• 카카오톡 이모티콘 제출 규격 검사
• 파일 형식, 크기, 용량, 개수 검증

이모티콘 사양

멈춰있는 이모티콘 (static)

항목	사양
이모티콘 이미지	32개, PNG, 360×360px, 150KB
아이콘 이미지	1개, PNG, 78×78px, 16KB

움직이는 이모티콘 (dynamic)

항목	사양
이모티콘 이미지	24개, WebP, 360×360px, 650KB
아이콘 이미지	1개, PNG, 78×78px, 16KB

큰 이모티콘 (big)

항목	사양
이모티콘 이미지	16개, WebP, 540×540px / 300×540px / 540×300px, 1MB
아이콘 이미지	1개, PNG, 78×78px, 16KB

멈춰있는 미니 이모티콘 (static-mini)

항목	사양
이모티콘 이미지	42개, PNG, 180×180px, 100KB

움직이는 미니 이모티콘 (dynamic-mini)

항목	사양
이모티콘 이미지	35개, WebP, 180×180px, 500KB

Hugging Face 토큰 인증

이모티콘 생성(generate 도구)을 사용하려면 Hugging Face API 토큰이 필요합니다.

Authorization 헤더로 토큰 전달

HTTP 요청의 Authorization 헤더에 Bearer 토큰으로 전달합니다.

Authorization: Bearer hf_xxxxxxxxxxxxxxxxxxxxx

PlayMCP에서 사용 시, PlayMCP의 인증 설정을 통해 토큰을 안전하게 저장하고 자동으로 전달할 수 있습니다.

Hugging Face 토큰 발급

1. Hugging Face에 로그인
2. Settings → Access Tokens 이동
3. "New token" 클릭
4. 토큰 이름 입력 및 권한 설정 (read 권한 필요)
5. 생성된 hf_xxx... 토큰을 안전하게 보관

설치 및 실행

1. 의존성 설치

pip install -r requirements.txt

2. 환경 변수 설정 (선택)

# 서버 설정 (선택)
export HOST="0.0.0.0"
export PORT="8000"
export BASE_URL="https://your-server-url.com"

# Redis 설정 (권장 - 설정하지 않으면 메모리 저장소 사용)
export REDIS_URL="redis://localhost:6379"
# 또는 비밀번호가 있는 경우:
# export REDIS_URL="redis://:password@host:port"

참고: Hugging Face 토큰은 환경 변수가 아닌, 사용자가 Authorization 헤더 또는 hf_token 파라미터로 전달해야 합니다.

3. 서버 실행

python server.py

또는

uvicorn server:app --host 0.0.0.0 --port 8000

Railway 배포

1. Railway 프로젝트 생성

1. Railway에 로그인
2. "New Project" 클릭
3. "Deploy from GitHub repo" 선택
4. 이 레포지토리 선택

2. 환경 변수 설정 (선택)

Railway 대시보드에서 Variables 탭에 다음 환경변수를 추가할 수 있습니다:

변수명	설명	필수
BASE_URL	배포된 서버 URL (Railway가 자동 생성)	❌
REDIS_URL	Redis 연결 URL (권장 - 데이터 영속성)	❌

참고: PORT는 Railway가 자동으로 설정합니다. Hugging Face 토큰은 사용자가 직접 전달합니다.

3. 배포 확인

• Railway가 자동으로 빌드 및 배포
• 제공된 URL로 접속하여 확인: https://playmcp-kakaotalk-emoticon.bloupla.net/health

4. PlayMCP 등록

배포 후 MCP SSE 엔드포인트 URL을 PlayMCP에 등록:

https://playmcp-kakaotalk-emoticon.bloupla.net/sse

PlayMCP 등록

1. PlayMCP에 카카오 계정으로 로그인
2. MCP 서버 등록 메뉴에서 서버 URL 입력
3. 허깅페이스 계정 연동 설정
4. 테스트 후 공개 전환

API 사용 예시

before-preview

{
  "emoticon_type": "static",
  "title": "귀여운 고양이",
  "plans": [
    {"description": "인사하는 고양이", "file_type": "PNG"},
    {"description": "졸린 고양이", "file_type": "PNG"}
  ]
}

generate

{
  "emoticon_type": "static",
  "character_image": "data:image/png;base64,...",
  "emoticons": [
    {"description": "고양이가 손을 흔들며 인사하는 모습", "file_extension": "png"},
    {"description": "고양이가 눈을 감고 졸고 있는 모습", "file_extension": "png"}
  ]
}

after-preview

{
  "emoticon_type": "static",
  "title": "귀여운 고양이",
  "emoticons": [
    {"image_data": "data:image/png;base64,..."},
    {"image_data": "data:image/png;base64,..."}
  ],
  "icon": "data:image/png;base64,..."
}

check

{
  "emoticon_type": "static",
  "emoticons": [
    {"file_data": "base64...", "filename": "emoticon_01.png"}
  ],
  "icon": {"file_data": "base64...", "filename": "icon.png"}
}

사용 모델

• 이미지 편집: Qwen/Qwen-Image-Edit
• 비디오 생성: Wan-AI/Wan2.1-I2V-14B-480P
• 캐릭터 생성: black-forest-labs/FLUX.1-schnell

라이선스

MIT License