fashio-mcp

面向 Fashio API 的 MCP（Model Context Protocol）服务器 — 让 Claude、Cursor 以及其他支持 MCP 的智能体能够直接以工具调用的形式生成模特上身时尚照片。

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 以托管 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_..." }
    }
  }
}

Related MCP server: Photo AI Studio MCP Server

工具

有关这些工具所封装端点的完整参考，请参见 docs.fashiolabs.com；另有一份为 LLM 一次性读完而编写的纯文本版本，见 docs.fashiolabs.com/llms-full.txt — 其中说明了每个 toolId 需要哪些 images.* 字段。

计费

没有独立的 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)

链接

• fashiolabs.com — 产品

• docs.fashiolabs.com — 完整 API 参考

• fashiolabs.com/mcp — MCP 配置指南

• fashiolabs.com/pricing — 套餐与积分包

许可证

MIT — 参见 LICENSE。