HeyBeauty MCP サーバー

HeyBeautyバーチャル試着

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

• URIとメタデータで衣服を表すリソース

• トライオンタスクを送信し、タスク情報を照会するためのツール。

• 試着布のプロンプト。

クイックスタート

1. HeyBeauty APIキーを申請する

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 tryonの構造化されたプロンプトを返します

リソース

• cloth:// - 衣服のURI

  • 各布にはID、名前、説明、画像URL、メタデータがあります

Related MCP server: mcp-flux-schnell

発達

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

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

デバッグ

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

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。