Freepik MCP Server
@MCERQUA
MCP server for interacting with Freepik's API, including stock photos and Mystic AI image generation
概要
What is Freepik MCP Server?
An MCP server implementation for interacting with Freepik’s API, providing access to stock photos (including vectors and PSDs) and Mystic AI image generation capabilities. It is designed for developers who want to search, retrieve details about, download Freepik resources, and generate AI images via the Model Context Protocol.
How to use Freepik MCP Server?
Requires Node.js 18+ and a Freepik API key. Clone the repository, install dependencies (npm install), and build (npm run build). Then add the server to your MCP settings file with the command node, the path to the built index.js, and the FREEPIK_API_KEY environment variable. Five tools are available: search_resources, get_resource, download_resource, generate_image, and check_status.
Key features of Freepik MCP Server
- Search Freepik resources with filters (orientation, content type, license).
- Get detailed information about a specific resource.
- Download resources via a generated URL.
- Generate images using Freepik Mystic AI.
- Check status of an image generation task.
Use cases of Freepik MCP Server
- Searching and filtering Freepik stock photos, vectors, and PSDs.
- Retrieving detailed metadata for a specific resource.
- Downloading resources directly through the API.
- Generating custom images from text prompts with Mystic AI.
- Polling the generation task to know when the image is ready.
FAQ from Freepik MCP Server
What prerequisites are needed to use Freepik MCP Server?
You need Node.js 18 or higher and a valid Freepik API key.
How do I install and configure the server?
Clone the repository, run npm install and npm run build, then add the server configuration to your MCP settings file with the necessary environment variable (FREEPIK_API_KEY).
What tools does Freepik MCP Server provide?
Five tools: search_resources, get_resource, download_resource, generate_image, and check_status. Each accepts parameters documented in the README.
How do I generate an image with Mystic AI?
Use the generate_image tool with a text prompt. You can optionally set resolution, aspect ratio, realism, engine, and creative detailing (0–100).
How do I obtain a Freepik API key?
Follow the instructions provided in the docs/API_SETUP.md file included in the repository.
