fashio-mcp

Сервер MCP (Model Context Protocol) для Fashio API — позволяет Claude, Cursor и другим MCP-агентам напрямую генерировать фотографии одежды на моделях в виде вызовов инструментов.

Fashio превращает фото одежды или товара в готовые к публикации фотографии и видео для e-commerce с помощью ИИ — виртуальная примерка, пакеты для каталога, удаление фона, повышение разрешения, перекадрирование и многое другое. Этот пакет — официальный MCP-клиент для его публичного v1 REST API.

Это тонкая обёртка: каждый инструмент здесь вызывает тот же публичный v1 REST API api.fashiolabs.com, который вызвал бы и curl-скрипт. Локальной бизнес-логики нет — источником истины является API.

Настройка

1. Создайте бесплатный API-ключ: fashiolabs.com → Profile → API Keys.

2. Добавьте Fashio в ваш MCP-клиент — выберите один из двух вариантов ниже.

Вариант A — Remote (размещённый, без установки)

mcp.fashiolabs.com запускает этот же сервер как размещённый HTTP-эндпоинт — ничего устанавливать не нужно, просто добавьте URL с вашим ключом в качестве bearer-токена:

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

(Точные названия полей и элементов интерфейса конфигурации различаются в зависимости от клиента — Claude Desktop, Claude Code и Cursor поддерживают добавление удалённого/HTTP MCP-сервера по URL с собственными заголовками по состоянию на 2026 год.)

Вариант B — Local (этот пакет, stdio)

Запускается на вашей собственной машине вместо размещённого эндпоинта — те же инструменты, те же условия оплаты.

Claude Desktop / Claude Code

claude_desktop_config.json (или .mcp.json для Claude Code):

{
  "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, а docs.fashiolabs.com/llms-full.txt — это простая текстовая версия, рассчитанная на чтение LLM за один проход; в ней указано, какие поля images.* требуются каждому toolId.

Оплата

Отдельного тарифа для MCP или API не существует. Каждый вызов create_generation списывает алмазы (кредитную единицу Fashio) с аккаунта, которому принадлежит API-ключ, — точно так же, как это сделала бы генерация из приложения или дашборда. Неудачная генерация автоматически возвращает алмазы.

Разработка

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