Heybeauty MCP

🚀 HeyBeauty MCP サーバー

HeyBeauty は仮想試着機能を提供します。このサーバーは TypeScript で構築された MCP サーバーで、HeyBeauty API を使用して仮想試着機能を実現します。以下の方法で核心的な MCP 概念をデモンストレーションします。

• cloth:// 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 を提供します。ブラウザで開いてください。