Freepik Flux AI MCP Sunucusu

April 6, 2025 · View on GitHub

Bu proje, Claude Desktop için Freepik'in Flux AI görsel üretme hizmetini kullanarak metin açıklamalarından görseller oluşturan bir Model Context Protocol (MCP) sunucusudur.

Özellikler

  • Metin açıklamalarından görsel oluşturma
  • Çeşitli en-boy oranı seçenekleri
  • Tarayıcıda otomatik görsel açma
  • Sağlam hata yönetimi ve yeniden deneme mekanizması

Gereksinimler

Kurulum

  1. Bu depoyu klonlayın veya indirin:
git clone https://github.com/grafikogr/freepik-mcp-server.git
cd freepik-mcp-server
  1. Bağımlılıkları yükleyin:
npm install
  1. .env.example dosyasını .env olarak kopyalayın ve Freepik API anahtarınızı ekleyin:
cp .env.example .env
  1. .env dosyasını düzenleyin ve FREEPIK_API_KEY değişkenini kendi API anahtarınızla değiştirin.

Kullanım

  1. Sunucuyu başlatın:
npm start
  1. Claude Desktop uygulamanızda bu sunucuyu aşağıdaki komutla çalıştırın:
@freepik help

Claude Desktop Entegrasyonu

Claude Desktop'ta MCP sunucusunu yapılandırmak için şu adımları izleyin:

  1. Claude Desktop ayarlarına gidin.
  2. mcpServers bölümüne şu yapılandırmayı ekleyin:
"mcpServers": {
  "freepik": {
    "command": "node",
    "args": ["indirdiğiniz/konum/freepik-mcp-server/index.js"]
  }
}
  1. Claude Desktop'u yeniden başlatın.

Araçlar

generate_image

Metin açıklaması ve görsel oranı (isteğe bağlı) ile görsel oluşturur.

Parametreler:

  • prompt: Görsel için metin açıklaması (zorunlu)
  • aspect_ratio: Görsel oranı (isteğe bağlı)

Kullanılabilir Görsel Oranları:

  • square_1_1: Kare (1:1)
  • classic_4_3: Klasik (4:3)
  • traditional_3_4: Geleneksel (3:4)
  • widescreen_16_9: Geniş ekran (16:9)
  • social_story_9_16: Sosyal medya hikayesi (9:16)
  • standard_3_2: Standart (3:2)
  • portrait_2_3: Portre (2:3)
  • horizontal_2_1: Yatay (2:1)
  • vertical_1_2: Dikey (1:2)
  • social_post_4_5: Sosyal medya gönderisi (4:5)

Konfigürasyon

.env dosyasında aşağıdaki ayarları yapılandırabilirsiniz:

  • FREEPIK_API_KEY: Freepik API anahtarınız (zorunlu)
  • REQUEST_TIMEOUT: İstek zaman aşımı süresi (milisaniye, varsayılan: 30000)
  • RETRY_ATTEMPTS: Başarısız isteklerin yeniden deneme sayısı (varsayılan: 3)

Örnekler

  1. Basit bir görsel oluşturma:

    @freepik Bana bir kedi görseli oluştur

  2. Belirli bir en-boy oranıyla görsel oluşturma:

    @freepik Bana widescreen_16_9 oranında dağ manzarası oluştur

Sorun Giderme

  • API anahtarı sorunları için .env dosyasını kontrol edin ve Freepik API anahtarınızın doğru olduğundan emin olun.
  • Ağ bağlantı sorunları için internet bağlantınızı kontrol edin.
  • Sunucu çalışma sorunları için Node.js sürümünüzün 20.x veya üstü olduğundan emin olun.
  • Daha fazla hata ayıklama bilgisi için konsol çıktısını kontrol edin.

Lisans

Bu proje MIT lisansı altında lisanslanmıştır.