Logo Generation

Provides logo generation capabilities using FAL AI, with tools for image generation, background removal, and automatic scaling.

python

170

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "arekhalpern-mcp-logo-gen": {
      "command": "python",
      "args": [
        "run_server.py"
      ],
      "env": {
        "FAL_KEY": "YOUR_FAL_AI_KEY_HERE"
      }
    }
  }
}

You can run a dedicated MCP server that uses FAL AI to generate logos, perform background removal, and automatically scale images. This server exposes a callable endpoint for clients to generate logos in multiple sizes while keeping transparency intact for PNG outputs.

How to use

You use an MCP client to connect to the local server and issue logo generation commands. Start the server, provide your FAL AI API key, and then request image generation with your prompts. The server will return a logo in three sizes: the original, 32x32, and 128x128, all with transparent backgrounds where applicable.

How to install

Install the required tooling and dependencies before running the server.

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

Create and activate a virtual environment with the provided tool.

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

Install required Python dependencies for the server.

uv pip install -r requirements.txt

Prepare environment variables for API access. Create a .env file in the project root and set your FAL AI API key.

FAL_KEY=your_fal_ai_key_here

Run the server

Start the MCP server using Python. It will be available at the local address shown below.

python run_server.py

The server will be available at http://127.0.0.1:7777

## Troubleshooting

If you encounter a FileNotFoundError on Windows when running the server, ensure you are executing from the project root. If problems persist, update to the latest version to include Windows compatibility fixes.

For Windows users specifically, follow these steps to ensure proper execution:

Activate the virtual environment: .venv\Scripts\activate
Run from the root directory: python run_server.py
If path-related errors occur, report them in the issues section of the project ``

## Notes

Reference the logging and prompts structure used by the server when crafting inputs for consistent results. All generated logos are saved to the downloads directory and produced in three sizes: Original, 32x32, and 128x128, preserving transparency in PNG outputs.

## Cursor IDE Configuration

Configure your Cursor IDE to connect to the MCP server for real-time logo generation and previewing.

## Available tools

### generate\_image

Generates an image based on a text prompt, supports image generation, background removal, and scaling as part of the logo creation workflow.