Freepik MCP

🚀 MCP-Server für nahtlose Freepik-API-Integration

🎯 Was ist das?

A Model Context Protocol (MCP) Server, der Ihre KI-Assistenten (Claude, Cursor usw.) direkt mit den leistungsstarken APIs von Freepik verbindet. Generieren, suchen und verwalten Sie visuelle Inhalte, ohne Ihren KI-Workflow zu verlassen.

🛠️ Welche Tools sind verfügbar?

• 🎨 Icon-Suche & Download - Icons in verschiedenen Formaten finden und herunterladen

• 📁 Ressourcenverwaltung - Multimedia-Inhalte abrufen und verwalten

• 🤖 KI-Bildklassifizierung - Bilder automatisch klassifizieren und analysieren

• 🖼️ Bildgenerierung - Eigene Bilder mit Mystic AI erstellen

📋 Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Python 3.12+ installiert

• uv Abhängigkeitsmanager (hier installieren)

• Freepik API-Schlüssel (hier erhalten)

🚀 Installation

1. Klonen und navigieren

git clone <REPOSITORY_URL>
cd freepik-mcp

2. Installation mit Makefile

# Install dependencies
make install

# Verify installation
make version

3. API-Schlüssel konfigurieren

echo "FREEPIK_API_KEY=your_api_key_here" > .env

💡 Holen Sie sich Ihren API-Schlüssel unter: freepik.com/api

⚙️ Konfiguration für KI-Assistenten

Für Claude Desktop oder Cursor unter Linux

Fügen Sie dies Ihrer config.json-Datei hinzu:

⚠️ Für Windows-Benutzer: Wenn Sie Windows verwenden, müssen Sie WSL (Windows Subsystem for Linux) nutzen, um diesen MCP-Server auszuführen.

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

🔧 Wichtige Konfigurationsschritte

1. Finden Sie Ihren vollständigen Pfad:

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

2. Ersetzen Sie ihn durch Ihren API-Schlüssel:

   • Erhalten Sie ihn unter freepik.com/api

   • Ersetzen Sie your_actual_api_key_here

🏃♂️ Schnellstart

# 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

🤝 Mitwirken

Wir freuen uns über Beiträge! Bitte befolgen Sie diese Richtlinien:

📝 Commit-Konvention

Dieses Projekt verwendet Conventional Commits. Formatieren Sie Ihre Commits wie folgt:

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

[optional body]

[optional footer(s)]

Typen:

• feat: Neue Funktion

• fix: Fehlerbehebung

• docs: Dokumentationsänderungen

• style: Änderungen am Codestil (Formatierung usw.)

• refactor: Code-Refactoring

• test: Hinzufügen oder Aktualisieren von Tests

• chore: Wartungsaufgaben

Beispiele:

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

🔄 Workflow für Beiträge

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch: git checkout -b feat/amazing-feature

3. Commiten Sie im konventionellen Format: git commit -m "feat: add amazing feature"

4. Pushen Sie auf Ihren Branch: git push origin feat/amazing-feature

5. Öffnen Sie einen Pull Request

📚 Entwicklungsbefehle

🛡️ Sicherheit

• ⚠️ Commiten Sie niemals Ihren API-Schlüssel

• ✅ Verwenden Sie .env-Dateien für sensible Daten

• ✅ Die .env-Datei ist in .gitignore enthalten

📖 API-Dokumentation

Für detaillierte API-Informationen:

• Freepik API-Dokumentation

🆘 Fehlerbehebung

Häufige Probleme:

1. "Command not found" → Installieren Sie den uv-Abhängigkeitsmanager

2. "Invalid API Key" → Überprüfen Sie Ihren Schlüssel unter freepik.com/api

3. "Path not found" → Überprüfen Sie den vollständigen Pfad in Ihrer Konfiguration

4. "Connection refused" → Stellen Sie sicher, dass der Server mit make dev läuft

Haben Sie weiterhin Probleme? Öffnen Sie ein Issue auf GitHub mit:

• Ihrem Betriebssystem und Ihrer Python-Version

• Vollständiger Fehlermeldung

• Konfigurationsdatei (ohne API-Schlüssel)

Bereit, fantastische Inhalte mit KI zu erstellen? 🎨✨