Fal.ai OpenAI Image

Un servidor para la API de texto a imagen de Fal.ai, impulsado por el modelo de imagen de OpenAI. Requiere claves de API de Fal.ai y OpenAI.

Documentación

Servidor MCP de Fal.ai OpenAI Image

Servidor FastMCP que genera imágenes utilizando la API de text-to-image GPT image-1 de fal.ai.

Configuración

  1. Instala las dependencias:
npm install
  1. Configura tu clave de API como variable de entorno:
export FAL_KEY="your_fal_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
  1. Compila el proyecto:
npm run build
  1. Ejecuta el servidor:
npm start

Uso

El servidor proporciona la siguiente herramienta:

generate_image

Genera una imagen utilizando un prompt de texto.

Parámetros:

  • prompt (obligatorio): Descripción textual de la imagen a generar
  • image_size (opcional): Tamaño de la imagen a generar ("auto", "1024x1024", "1536x1024", "1024x1536")
  • num_images (opcional): Número de imágenes a generar (1-4)
  • quality (opcional): Calidad de la imagen a generar ("auto", "low", "medium", "high")
  • background (opcional): Tipo de fondo ("auto", "transparent", "opaque")

Ejemplo:

{
  "prompt": "夕暮れの静謐なサイバーパンク都市風景",
  "image_size": "1024x1024",
  "num_images": 1,
  "quality": "high"
}

Uso con Claude Code

Para usar este servidor con Claude Code, añade el siguiente JSON a tu configuración de MCP:

{
  "mcpServers": {
    "fal-openai-image": {
      "command": "node",
      "args": ["/path/to/fal_openai_image1/dist/index.js"],
      "env": {
        "FAL_KEY": "your_fal_api_key_here",
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

O, si lo ejecutas en modo de desarrollo:

{
  "mcpServers": {
    "fal-openai-image": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/fal_openai_image1",
      "env": {
        "FAL_KEY": "your_fal_api_key_here",
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

Variables de entorno

  • FAL_KEY: Obligatorio. Clave de API para la autenticación con la API de fal.ai
  • OPENAI_API_KEY: Obligatorio. Clave de API de OpenAI para el sistema BYOK (Bring Your Own Key)