Fashio AI

fashio-mcp

Fashio API 用の MCP（Model Context Protocol）サーバーです。Claude、Cursor、その他の MCP 対応エージェントから、ツール呼び出しとしてモデル着用のファッション写真を直接生成できます。

Fashio は、AI を使って衣服や商品の写真を、公開可能な品質の e コマース向け写真や動画に変換します。バーチャル試着、カタログ一式の作成、背景の削除、アップスケーリング、リフレーミングなどに対応しています。このパッケージは、公開 v1 REST API 用の公式 MCP クライアントです。

これは薄いラッパーです。ここにある各ツールはすべて、curl スクリプトと同じ公開 api.fashiolabs.com v1 REST API を呼び出します。ローカルのビジネスロジックはなく、API が唯一の信頼できる情報源です。

セットアップ

1. fashiolabs.com → Profile → API Keys で無料の API キーを作成します。
2. 以下の 2 つの方法から選び、Fashio を MCP クライアントに追加します。

オプション A — リモート（ホスト型、インストール不要）

mcp.fashiolabs.com は、この同じサーバーをホスト型 HTTP エンドポイントとして実行しています。インストールは不要で、キーをベアラートークンとして URL を追加するだけです。

{
  "mcpServers": {
    "fashio": {
      "url": "https://mcp.fashiolabs.com/mcp",
      "headers": {
        "Authorization": "Bearer fio_live_..."
      }
    }
  }
}

（設定 UI やフィールド名はクライアントによって異なります。2026 年時点で、Claude Desktop、Claude Code、Cursor はすべて、カスタムヘッダーを指定して URL でリモート／HTTP MCP サーバーを追加できます。）

オプション B — ローカル（このパッケージ、stdio）

ホスト型エンドポイントではなく、お使いのマシン上で実行します。ツールも料金体系も同じです。

Claude Desktop / Claude Code

claude_desktop_config.json（Claude Code の場合は .mcp.json）：

{
  "mcpServers": {
    "fashio": {
      "command": "npx",
      "args": ["-y", "fashio-mcp"],
      "env": {
        "FASHIO_API_KEY": "fio_live_..."
      }
    }
  }
}

ソースから実行

git clone https://github.com/fashiolabs/fashio-mcp.git
cd fashio-mcp
npm install
npm run build

次に、クライアントの設定で npx の代わりにビルド済みのエントリーポイントを指定します。

{
  "mcpServers": {
    "fashio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": { "FASHIO_API_KEY": "fio_live_..." }
    }
  }
}

ツール

ツール	説明
list_models	create_generation で使用できるすべての有効な toolId と、入力形式およびデフォルト価格を返します。
list_fashion_models	AI モデルのカタログを閲覧します（gender、limit）。
list_venues	会場／背景のカタログを閲覧します（limit）。
list_poses	ポーズのカタログを閲覧します（type、limit）。
upload_image	ローカルファイル（jpg/png/webp、最大 8MB）をアップロードし、使用可能な URL を返します。
create_generation	ジョブを開始します。リクエスト形式は POST /v1/generations と同じです。{id, status: "processing"} を返します。手動で fashion_model／venue／pose を選ぶ代わりに、保存済みのスタイルを再利用するには templateSetId を渡します。
get_generation	status が completed または failed になるまで、id でジョブの状態を確認します。
get_account	API キーを所有するアカウントのメールアドレス、プラン、ダイヤモンド（クレジット）残高、更新日を返します。
create_template_set	完了した生成の fashion_model／venue／pose／shotType／stylePreset／ratio を名前付きプリセットとして保存します。create_generation の templateSetId を使って、新しい衣服に再利用できます。
list_template_sets	create_template_set で保存したプリセットを一覧表示します。
delete_template_set	保存済みのプリセットを削除します。
list_ready_template_sets	Fashio が独自に厳選した「すぐに使える撮影セット」ライブラリ（モデル＋会場＋固定ポーズ）を閲覧します。上記の自分の保存済みプリセットとは異なる、より大規模なカタログです。
get_ready_template_set	厳選されたセットを、すべてのショットの一覧を含めて取得します。
create_catalog_job	商品写真を、厳選された撮影セットのすべてのショット（または選択したショット）で処理します。ショットごとに 1 枚生成され、料金もショットごとに発生します。get_generation で状態を確認します。

このツールがラップするエンドポイントの詳細については、docs.fashiolabs.com を参照してください。また、LLM が一度に読み取れるように書かれたプレーンテキスト版（各 toolId が必要とする images.* フィールドを含む）は、docs.fashiolabs.com/llms-full.txt を参照してください。

料金

MCP や API 専用のプランはありません。create_generation を呼び出すたびに、API キーを所有するアカウントからダイヤモンド（Fashio のクレジット単位）が差し引かれます。アプリやダッシュボードから生成する場合とまったく同じです。生成に失敗した場合、ダイヤモンドは自動的に返金されます。

開発

npm run dev    # tsc --watch
npm run build
npm start      # runs dist/index.js directly (expects FASHIO_API_KEY in env)

Links

• fashiolabs.com — product
• docs.fashiolabs.com — full API reference
• fashiolabs.com/mcp — MCP setup guide
• fashiolabs.com/pricing — plans & credit packs

License

MIT — see LICENSE.