Fal.ai OpenAI Image MCP Server

# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Common Commands - **Development**: `npm run dev` - Run server in development mode with hot reload - **Build**: `npm run build` - Compile TypeScript to JavaScript in dist/ - **Production**: `npm start` - Run the compiled server from dist/ ## Environment Variables This MCP server requires two API keys to function: - `FAL_KEY` - Authentication for fal.ai API - `OPENAI_API_KEY` - Used in BYOK (Bring Your Own Key) system for image generation ## Architecture This is a FastMCP (Model Context Protocol) server that bridges fal.ai's GPT image-1 text-to-image API. **Core Structure:** - Single TypeScript file (`src/index.ts`) implementing the MCP server - Uses `@modelcontextprotocol/sdk` for MCP protocol handling - StdioServerTransport for communication - Single tool: `generate_image` with comprehensive parameter validation **API Integration:** - Makes HTTP requests to `https://fal.run/fal-ai/gpt-image-1/text-to-image/byok` - Dual authentication: fal.ai API key in Authorization header + OpenAI key in request body - Supports image size, quality, background, and count parameters - Returns structured JSON with image URLs or error details **Error Handling:** - Environment variable validation at runtime - API response error handling with detailed messages - Structured error responses in MCP format