🎬 Higgsfield MCP Server

Servidor MCP para usar Higgsfield AI desde Claude Desktop, Perplexity (Pro/Max/Enterprise) y cualquier cliente MCP compatible.

Genera imágenes y videos con IA de alta calidad desde tu chat.

Herramientas disponibles

Herramienta	Descripción
generate_image	Genera imágenes (Nano Banana, FLUX, GPT Image, etc.)
generate_video	Genera videos (Seedance 2.0, Kling 2.5, Sora 2, Wan 2.5, etc.)
check_status	Consulta el estado de una generación por request_id
cancel_generation	Cancela una generación en cola

---

🟣 Opción A: Deploy en Fly.io (para Perplexity)

Perplexity requiere una URL pública HTTP/SSE. Deploy en Fly.io en menos de 2 minutos:

git clone https://github.com/luisitoys12/higgsfield-mcp
cd higgsfield-mcp
npm install

# Crear app en Fly.io
fly apps create higgsfield-mcp

# Definir secrets (API keys de Higgsfield)
fly secrets set HIGGSFIELD_API_KEY=tu_api_key_aqui
fly secrets set HIGGSFIELD_API_SECRET=tu_api_secret_aqui

# Deploy
fly deploy

Tu URL SSE será: https://higgsfield-mcp.fly.dev/sse

Conectar en Perplexity

1. Ve a Perplexity → Settings → AI → Connectors (o MCP Servers)
2. Haz click en + Add custom connector
3. Ingresa:
   • Name: Higgsfield AI
   • URL: https://higgsfield-mcp.fly.dev/sse
   • Auth: Open (sin autenticación adicional, las keys ya están en el servidor)
4. Guarda y listo ✅

Requiere suscripción Pro, Max o Enterprise de Perplexity.

---

💙 Opción B: Claude Desktop (stdio local)

git clone https://github.com/luisitoys12/higgsfield-mcp
cd higgsfield-mcp
npm install

Edita claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "higgsfield": {
      "command": "node",
      "args": ["/ruta/completa/a/higgsfield-mcp/index.js"],
      "env": {
        "HIGGSFIELD_API_KEY": "tu_api_key_aqui",
        "HIGGSFIELD_API_SECRET": "tu_api_secret_aqui"
      }
    }
  }
}

---

Modelos disponibles

Imágenes

Model ID	Modelo
higgsfield-ai/nano-banana/pro	Nano Banana Pro (foto-realista)
higgsfield-ai/flux-kontext/standard	FLUX Kontext
higgsfield-ai/gpt-image/standard	GPT Image 2

Videos

Model ID	Modelo
higgsfield-ai/seedance/v2	Seedance 2.0 ✅ recomendado
higgsfield-ai/kling/v2-5-turbo	Kling 2.5 Turbo
higgsfield-ai/sora/v2	Sora 2
higgsfield-ai/wan/v2-5	Wan 2.5
higgsfield-ai/minimax-hailuo/02	MiniMax Hailuo 02

---

Licencia

MIT — Hecho con ❤️ por Estacionkusmedios