FAL AI Image Generation

🚀 MCP Tool Server for Logo Generation

This server offers logo generation functionality using FAL AI, equipped with image generation, background removal, and auto - scaling tools.

🚀 Quick Start

✨ Features

• Provide logo generation using FAL AI.
• Equipped with image generation, background removal, and auto - scaling tools.

📦 Installation

1. Install uv (Universal Virtual Environment):

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Create and activate a virtual environment:

uv venv
source .venv/bin/activate  # On Unix/macOS systems
# Or
.venv\Scripts\activate     # On Windows systems

3. Install dependencies:

uv pip install -r requirements.txt

4. Set environment variables:
   • Create a .env file in the project root directory.
   • Add your FAL AI API key:

FAL_KEY=your_fal_ai_key_here

💻 Usage Examples

Basic Usage

To start the server, use the following command:

python run_server.py

The server will run at http://127.0.0.1:7777.

Troubleshooting

If you encounter a FileNotFoundError when running the server on a Windows system, make sure to run the commands from the project root directory. If the problem persists, update to the latest version of the repository, which contains fixes for Windows compatibility.

Specific instructions for Windows users:

1. Ensure you have activated the virtual environment .venv\Scripts\activate.
2. Run the server from the project root directory python run_server.py.
3. If you see any path - related errors, report them in the issues section of the repository.

📚 Documentation

Cursor IDE Configuration

1. Open Cursor settings.
2. Navigate to the MCP section.
3. Add the following configuration:
   • URL: http://127.0.0.1:7777/sse
   • Connection type: SSE
   • Enable this connection.

Notes

• Always refer to @logo - creation.mdc in your Cursor Composer for consistent results.
• The steps are defined in @logo - creation.mdc, but the tool can be used independently.
• All generated logos will be saved in the downloads directory.
• Each logo will be automatically generated in three sizes:
  • Original size
  • 32x32 pixels
  • 128x128 pixels
• All logos are saved in PNG format with transparency.
• The prompt information created by the proxy is customized according to the examples and prompt structure in server.py. You can customize the prompt structure by editing the server.py file.
• You can use the generate_image tool to generate any image, not just logos.

Requirements

• Python 3.8+ or higher.
• FAL AI API key (for image generation).
• An active internet connection.

References

• Cursor MCP Documentation
• Introduction to Model Context Protocol
• FAL AI Dashboard

If you find this tool helpful, you can Buy me a coffee ☕️ to support my development!