Fal.ai OpenAI Image

Servidor MCP Fal.ai OpenAI Image

Este é um servidor FastMCP que gera imagens usando a API text-to-image GPT image-1 da fal.ai.

Configuração

1. Instale as dependências:

npm install

2. Defina a chave de API como variável de ambiente:

export FAL_KEY="your_fal_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"

3. Compile o projeto:

npm run build

4. Execute o servidor:

npm start

Como usar

O servidor fornece as seguintes ferramentas:

generate_image

Gera uma imagem usando um prompt de texto.

Parâmetros:

• prompt (obrigatório): descrição textual da imagem a ser gerada
• image_size (opcional): tamanho da imagem a ser gerada ("auto", "1024x1024", "1536x1024", "1024x1536")
• num_images (opcional): número de imagens a serem geradas (1-4)
• quality (opcional): qualidade da imagem a ser gerada ("auto", "low", "medium", "high")
• background (opcional): tipo de fundo ("auto", "transparent", "opaque")

Exemplo:

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

Uso com Claude Code

Para usar este servidor com Claude Code, adicione o seguinte JSON à configuração do 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"
      }
    }
  }
}

Ou, para executar em modo de desenvolvimento:

{
  "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"
      }
    }
  }
}

Variáveis de ambiente

• FAL_KEY: obrigatório. Chave de API para autenticação na API da fal.ai
• OPENAI_API_KEY: obrigatório. Chave de API da OpenAI para o sistema BYOK (Bring Your Own Key)