fal-image-video-mcp

RamboRogers/fal-image-video-mcp

3.3

If you are the rightful owner of fal-image-video-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The FAL Image/Video MCP Server is a high-performance server designed to facilitate seamless integration between FAL AI's image and video generation capabilities and MCP-compatible clients.

The FAL Image/Video MCP Server acts as a bridge between FAL AI's advanced image and video generation technologies and clients that support the Model Context Protocol (MCP), such as Claude. This server allows users to generate high-quality images and videos using FAL AI's curated models and automatically downloads the generated content to the user's local machine. It provides public URLs, data URLs, and local file paths for easy access and sharing. The server is optimized for use with Claude Desktop, offering features like automatic file opening and customizable download paths. It supports multiple transport methods, including stdio for desktop applications and HTTP/SSE for web-based integrations. The server is built using TypeScript and Node.js, ensuring robust performance and compatibility with modern development environments.

Features

  • Seamless integration with FAL AI's image and video generation models.
  • Automatic downloading of generated content with customizable paths.
  • Support for public URLs, data URLs, and local file paths.
  • Optimized for Claude Desktop with features like auto-open and size limits.
  • Multi-transport support including stdio and HTTP/SSE.

Usages

npx with Claude Desktop

{
  "mcpServers": {
    "fal-image-video": {
      "command": "npx",
      "args": ["-y", "fal-image-video-mcp"],
      "env": {
        "FAL_KEY": "YOUR-FAL-AI-API-KEY"
      }
    }
  }
}

optimized npx with Claude Desktop

{
  "mcpServers": {
    "fal-image-video": {
      "command": "npx",
      "args": ["-y", "fal-image-video-mcp"],
      "env": {
        "FAL_KEY": "YOUR-FAL-AI-API-KEY",
        "DOWNLOAD_PATH": "/custom/download/path",
        "ENABLE_DATA_URLS": "true",
        "MAX_DATA_URL_SIZE": "1048576",
        "AUTOOPEN": "false"
      }
    }
  }
}

npx HTTP Server Mode

bash
npx -y fal-image-video-mcp --http

npx HTTP Server Mode with custom port

bash
PORT=8080 npx -y fal-image-video-mcp --http

npx HTTP Server Mode with custom transport flag

bash
MCP_TRANSPORT=http npx -y fal-image-video-mcp

global installation

bash
npm install -g fal-image-video-mcp
fal-image-video-mcp              # Stdio mode
fal-image-video-mcp --http       # HTTP mode

from source

bash
git clone https://github.com/RamboRogers/fal-image-video-mcp.git
cd fal-image-video-mcp
npm install
npm run build
npm start                    # Stdio mode
npm start -- --http         # HTTP mode

Tools

  1. imagen4

    Google's latest text-to-image model with superior quality.

  2. flux_kontext

    State-of-the-art prompt adherence and typography generation.

  3. ideogram_v3

    Advanced typography and realistic outputs.

  4. recraft_v3

    Professional design and illustration capabilities.

  5. kling_master_image

    Premium image-to-video conversion with motion fluidity.