Version française

An MCP (Model Context Protocol) server for interacting with the Freepik.com API.

• Python 3.10 or higher
• Freepik API key

1. Clone this repository
2. Install dependencies:

   pip install -e .

1. Obtain an API key from Freepik
2. Set the environment variable:

   export FREEPIK_API_KEY="your_api_key"

Start the MCP server:

python -m freepik_mcp_server.server

The server exposes the following tools:

Search for images on Freepik.

Parameters:

• query (required): Search term
• page: Page number (default: 1)
• limit: Results per page (default: 20, max: 100)
• orientation: Image orientation (landscape, portrait, square)
• color: Dominant color filter

Get details of a specific image.

Parameters:

• id (required): Freepik image ID

Search for vector graphics on Freepik.

Parameters:

• query (required): Search term
• page: Page number (default: 1)
• limit: Results per page (default: 20, max: 100)
• orientation: Vector orientation (landscape, portrait, square)

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "freepik": {
      "command": "python",
      "args": ["-m", "freepik_mcp_server.server"],
      "env": {
        "FREEPIK_API_KEY": "your_api_key"
      }
    }
  }
}

pip install -e ".[dev]"

pytest

flake8 src tests

freepik-mcp-server/
├── src/
│   └── freepik_mcp_server/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_server.py
├── .github/
│   └── workflows/
│       └── python-package.yml
├── .gitignore
├── LICENSE
├── README.md
├── README_FR.md
├── pyproject.toml
└── requirements.txt

• Advanced image search with filters
• Vector graphics search
• Retrieve specific image details
• Error handling and logging
• Automated testing
• GitHub Actions CI/CD

• Request limits depend on your subscription plan
• Some features require a premium account
• Results may vary by region

Contributions are welcome! Please see CONTRIBUTING.md for details.

This project is licensed under the MIT License - see the LICENSE file for details.