HeyBeauty MCP サーバー

HeyBeautyバーチャル試着

これは、HeyBeauty APIを使用して仮想試着を実装するTypeScriptベースのMCPサーバーです。以下の機能を提供することで、MCPのコアコンセプトを実証しています。

URIとメタデータで衣服を表すリソース
トライオンタスクを送信し、タスク情報を照会するためのツール。
試着布のプロンプト。

クイックスタート

HeyBeauty APIキーを申請する
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 tryonの構造化されたプロンプトを返します

リソース

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

Related MCP server: MCP Server Playground

発達

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

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 キーを取得するには、このドキュメントに従ってください。