freepik-mcp-server

freepik-mcp-server

0
entertainment_and_media

The Freepik Flux AI MCP Server is an MCP server that generates images from text descriptions using the Freepik API, designed to integrate with Claude Desktop. It offers various aspect ratio options and robust error handling.

Freepik Flux AI MCP Server

This project is a Model Context Protocol (MCP) server that uses Freepik's Flux AI image generation service to create images from text descriptions for Claude Desktop.

Features

  • Image generation from text descriptions
  • Various aspect ratio options
  • Automatic image opening in browser
  • Robust error handling and retry mechanism

Requirements

  • Node.js 20.x or higher
  • Freepik API key

Setup

  1. Clone or download the repository
  2. Install dependencies
  3. Copy .env.example to .env and add your Freepik API key

Usage

  1. Start the server
  2. Run the server in Claude Desktop with the command @freepik help

Claude Desktop Integration

Configure the MCP server in Claude Desktop by editing the settings to include the necessary configuration and restart Claude Desktop.

Tools

generate_image

Generates an image with optional aspect ratio from a text description. Available aspect ratios include square, classic, widescreen, and others.

Configuration

Configure settings in the .env file, including the Freepik API key, request timeout, and retry attempts.

Troubleshooting

Check the .env file for API key issues, ensure internet connectivity for network issues, and verify Node.js version for server operation problems. Check console output for more debugging information.