Playmcp Kakaotalk Emoticon

🚀 カカオ イモーティ콘 PlayMCP サーバ

このサーバは、カカオトークのイモーティコン制作を自動化し、または制作を支援するための MCP (Model Context Protocol) サーバです。

✨ 主な機能

1. before-preview (イモーティコン企画プレビュー)

• イモーティコン制作前の企画段階で使用します。
• カカオトークチャットルームスタイルのプレビューページを生成します。
• 各イモーティコンの位置に説明テキストを表示します。

2. generate (イモーティコン生成)

• Hugging Face API を使用して AI イモーティコンを生成します。
• キャラクター画像をベースにイモーティコンを制作します。キャラクター画像がない場合は自動生成します。
• アニメーションイモーティコンの場合、ビデオを生成した後に WebP に変換します。

3. after-preview (完成版プレビュー)

• 実際のイモーティコン画像が含まれたプレビューページを提供します。
• ZIP ファイルのダウンロード機能があります。
• イモーティコンをクリックすると拡大表示されます。

4. check (イモーティコン検査)

• カカオトークのイモーティコン提出規格を検査します。
• ファイル形式、サイズ、容量、個数を検証します。

📦 イモーティコン仕様

静止イモーティコン (static)

アニメーションイモーティコン (dynamic)

大型イモーティコン (big)

静止ミニイモーティコン (static - mini)

アニメーションミニイモーティコン (dynamic - mini)

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 タブに次の環境変数を追加できます:

⚠️ 重要提示

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. テスト後、公開に切り替えます。

💻 使用例

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