HeyBeauty MCP Server

HeyBeauty MCP サーバー

HeyBeauty バーチャル試着

これは、HeyBeauty API を使ってバーチャル試着を実装する、TypeScript ベースの MCP サーバーです。次の機能を提供し、MCP の基本概念を紹介します。

• URI とメタデータを持つ衣服を表すリソース
• 試着タスクの送信とタスク情報の照会を行うツール
• 衣服の試着用プロンプト

クイックスタート

1. HeyBeauty API Keyを申請します

2. MCP クライアントの設定ファイルにサーバー設定を追加します

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "npx",
      "args": ["-y", "heybeauty-mcp"],
      "env": {
        "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
      }
    }
  }
}

リソース

• cloth:// URI を使って衣服を一覧表示し、アクセスできます
• 各衣服には ID、名前、説明、画像 URL、メタデータがあります
• シンプルにコンテンツへアクセスできるプレーンテキストの MIME タイプ

ツール

• submit_tryon_task - 試着タスクを送信します
  • ユーザー画像 URL、衣服画像 URL、衣服 ID、衣服の説明を必須パラメーターとして受け取ります
  • 試着タスクをサーバーの状態に保存します
• query_tryon_task - 試着タスクを照会します
  • タスク ID を必須パラメーターとして受け取ります
  • 試着タスクの情報を返します

プロンプト

• tryon_cloth - 衣服を試着します
  • ユーザー画像 URL、衣服画像 URL、衣服 ID、衣服の説明を必須パラメーターとして受け取ります
  • LLM による試着用の構造化プロンプトを返します

リソース

• cloth:// - 衣服の URI
  • 各衣服には ID、名前、説明、画像 URL、メタデータがあります

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "node",
      "args": ["/path/to/heybeauty-mcp/build/index.js"]
    },
    "env": {
      "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
    }
  }
}

HeyBeauty API Key の取得方法は、このドキュメントを参照してください。

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できるMCP Inspectorの使用をおすすめします。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。