Freepik MCP

🚀 MCP-сервер для бесшовной интеграции с API Freepik

🎯 Что это такое?

Сервер протокола контекста модели (MCP), который напрямую подключает ваших ИИ-ассистентов (Claude, Cursor и др.) к мощным API Freepik. Генерируйте, ищите и управляйте визуальным контентом, не покидая рабочий процесс ИИ.

🛠️ Какие инструменты доступны?

• 🎨 Поиск и скачивание иконок — находите и скачивайте иконки в различных форматах

• 📁 Управление ресурсами — доступ к мультимедийному контенту и управление им

• 🤖 ИИ-классификация изображений — автоматическая классификация и анализ изображений

• 🖼️ Генерация изображений — создание пользовательских изображений с помощью Mystic AI

📋 Предварительные требования

Перед началом убедитесь, что у вас есть:

• Установленный Python 3.12+

• Менеджер зависимостей uv (установить здесь)

• API-ключ Freepik (получить здесь)

🚀 Установка

1. Клонируйте репозиторий и перейдите в папку

git clone <REPOSITORY_URL>
cd freepik-mcp

2. Установите с помощью Makefile

# Install dependencies
make install

# Verify installation
make version

3. Настройте свой API-ключ

echo "FREEPIK_API_KEY=your_api_key_here" > .env

💡 Получите свой API-ключ на сайте: freepik.com/api

⚙️ Настройка для ИИ-ассистентов

Для Claude Desktop или Cursor в Linux

Добавьте это в ваш файл config.json:

⚠️ Для пользователей Windows: Если вы используете Windows, вам нужно использовать WSL (подсистему Windows для Linux) для запуска этого MCP-сервера.

{
  "mcpServers": {
    "freepik-fastmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/FULL/PATH/TO/freepik-mcp",
        "main.py"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

🔧 Важные шаги по настройке

1. Найдите свой полный путь:

   pwd
   # Copy the output and replace /FULL/PATH/TO/ in the config

2. Замените на свой API-ключ:

   • Получите его на freepik.com/api

   • Замените your_actual_api_key_here

🏃♂️ Быстрый старт

# Development mode (auto-reload)
make dev

# Production mode
make run

# Check code quality
make lint

# Format code
make format

# Clean temporary files
make clean

# See all commands
make help

🤝 Участие в разработке

Мы приветствуем участие в разработке! Пожалуйста, следуйте этим рекомендациям:

📝 Соглашение о коммитах

Этот проект использует Conventional Commits. Форматируйте свои коммиты следующим образом:

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

Типы:

• feat: Новая функция

• fix: Исправление ошибки

• docs: Изменения в документации

• style: Изменения стиля кода (форматирование и т.д.)

• refactor: Рефакторинг кода

• test: Добавление или обновление тестов

• chore: Задачи по обслуживанию

Примеры:

feat(icons): add search filtering by category
fix(api): resolve authentication timeout issue
docs(readme): update installation instructions
refactor(mystic): improve error handling logic

🔄 Рабочий процесс внесения вклада

1. Сделайте форк репозитория

2. Создайте ветку для функции: git checkout -b feat/amazing-feature

3. Закоммитьте изменения, используя стандартный формат: git commit -m "feat: add amazing feature"

4. Отправьте изменения в свою ветку: git push origin feat/amazing-feature

5. Откройте Pull Request

📚 Команды разработки

🛡️ Безопасность

• ⚠️ Никогда не коммитьте свой API-ключ

• ✅ Используйте файлы .env для конфиденциальных данных

• ✅ Файл .env добавлен в .gitignore

📖 Документация API

Для получения подробной информации об API:

• Документация API Freepik

🆘 Устранение неполадок

Распространенные проблемы:

1. "Command not found" → Установите менеджер зависимостей uv

2. "Invalid API Key" → Проверьте свой ключ на freepik.com/api

3. "Path not found" → Проверьте полный путь в конфигурации

4. "Connection refused" → Убедитесь, что сервер запущен с помощью make dev

Проблемы не решены? Откройте issue на GitHub, указав:

• Вашу ОС и версию Python

• Полное сообщение об ошибке

• Файл конфигурации (без API-ключа)

Готовы создавать потрясающий контент с помощью ИИ? 🎨✨