Freepik Flux AI MCP Sunucusu

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

• Node.js 20.x veya üstü
• Freepik API anahtarı (https://www.freepik.com/developers/dashboard/api-key adresinden alınabilir)

Kurulum

1. Bu depoyu klonlayın veya indirin:

git clone https://github.com/grafikogr/freepik-mcp-server.git
cd freepik-mcp-server

2. Bağımlılıkları yükleyin:

npm install

3. .env.example dosyasını .env olarak kopyalayın ve Freepik API anahtarınızı ekleyin:

cp .env.example .env

4. .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

2. 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"]
  }
}

3. 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.