Fashio AI

fashio-mcp

适用于 Fashio API 的 MCP（Model Context Protocol）服务——让 Claude、Cursor 和其他支持 MCP 的 Agent 通过工具调用，直接生成真人上身的时尚照片。

Fashio 借助 AI 将服装或产品照片转化为可直接发布的电商摄影和视频，提供虚拟试穿、商品目录套图、背景移除、放大、重新构图等功能。此软件包是其公开 v1 REST API的官方 MCP 客户端。

这是一个轻量封装：此处的每个工具都会调用相同的公开 api.fashiolabs.com v1 REST API，与 curl 脚本的行为一致。没有本地业务逻辑——API 是事实来源。

设置

1. 在 fashiolabs.com → Profile → API Keys 创建免费 API 密钥。
2. 将 Fashio 添加到你的 MCP 客户端——选择以下两个选项之一。

选项 A — 远程（托管，无需安装）

mcp.fashiolabs.com 将同一 MCP 服务作为托管 HTTP 端点运行——无需安装，只需将 URL 和作为 bearer token 的密钥添加进去：

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

（不同客户端的配置界面和字段名称可能有所不同——截至 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"}。传入 templateSetId 可复用已保存的风格，无需手动选择 fashion_model/venue/pose。
get_generation	按 id 轮询任务，直到 status 为 completed 或 failed。
get_account	获取密钥所属账户的邮箱、套餐、diamond（积分）余额和续费日期。
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 自有的精选“ready photoshoot”库（模特 + 场景 + 固定姿势）——这是一个与上方个人保存的预设不同且规模更大的目录。
get_ready_template_set	获取一个精选套组，包括其完整镜头列表。
create_catalog_job	使用精选拍摄套组中的所有镜头（或选定子集）处理你的产品照片——每个镜头生成一张图片，并按镜头计费。使用 get_generation 轮询。

完整的端点参考见 docs.fashiolabs.com，其中列出了这些工具封装的端点；另请参阅 docs.fashiolabs.com/llms-full.txt，获取专为大模型一次性阅读而编写的纯文本版本，其中包括每个 toolId 所需的 images.* 字段。

计费

没有单独的 MCP 或 API 套餐。每次调用 create_generation 都会从 API 密钥所属账户扣除 diamonds（Fashio 的积分单位）——与从应用或控制台生成完全相同。生成失败时，系统会自动退还 diamonds。

开发

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.