fashio-mcp

Servidor MCP (Model Context Protocol) para la API de Fashio — permite que Claude, Cursor y otros agentes que usan MCP generen fotos de moda sobre modelos directamente, como llamadas a herramientas.

Fashio convierte una foto de prenda o producto en fotografía y vídeo de comercio electrónico listos para publicar, con IA: probador virtual, paquetes de catálogo, eliminación de fondos, ampliación, reencuadre y mucho más. Este paquete es el cliente MCP oficial de su API REST pública v1.

Es un envoltorio ligero: cada herramienta aquí llama a la misma API REST pública v1 de api.fashiolabs.com a la que llamaría un script de curl. No hay lógica de negocio local — la API es la fuente de verdad.

Configuración

1. Crea una clave de API gratuita en fashiolabs.com → Perfil → Claves de API.

2. Añade Fashio a tu cliente MCP — elige una de las dos opciones siguientes.

Opción A — Remoto (alojado, sin instalación)

mcp.fashiolabs.com ejecuta este mismo servidor como un endpoint HTTP alojado — no hay nada que instalar, solo añade la URL con tu clave como bearer token:

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

(Los nombres exactos de los campos/UI de configuración varían según el cliente — Claude Desktop, Claude Code y Cursor admiten añadir un servidor MCP remoto/HTTP por URL con cabeceras personalizadas a partir de 2026).

Opción B — Local (este paquete, stdio)

Se ejecuta en tu propia máquina en lugar de un endpoint alojado — mismas herramientas, misma facturación.

Claude Desktop / Claude Code

claude_desktop_config.json (o .mcp.json para Claude Code):

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

Ejecutar desde el código fuente

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

Luego apunta la configuración de tu cliente al punto de entrada compilado en lugar de a 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

Herramientas

Consulta docs.fashiolabs.com para la referencia completa de endpoints que estas herramientas envuelven, y docs.fashiolabs.com/llms-full.txt para una versión en texto plano escrita para que un LLM la lea de una sola pasada — incluyendo qué campos de images.* necesita cada toolId.

Facturación

No hay un plan separado de MCP ni de API. Cada llamada a create_generation descuenta diamantes (la unidad de crédito de Fashio) de la cuenta propietaria de la clave de API — exactamente igual que lo haría una generación desde la aplicación o el panel de control. Una generación fallida reembolsa sus diamantes automáticamente.

Desarrollo

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

Enlaces

• fashiolabs.com — producto

• docs.fashiolabs.com — referencia completa de la API

• fashiolabs.com/mcp — guía de configuración de MCP

• fashiolabs.com/pricing — planes y paquetes de crédito

Licencia

MIT — consulta LICENSE.