Freepik Flux AI MCP Sunucusu
MCP server for generating images with Freepik Flux-Dev API
grafikogr
README
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
- Bu depoyu klonlayın veya indirin:
git clone https://github.com/grafikogr/freepik-mcp-server.git
cd freepik-mcp-server
- Bağımlılıkları yükleyin:
npm install
.env.example
dosyasını.env
olarak kopyalayın ve Freepik API anahtarınızı ekleyin:
cp .env.example .env
.env
dosyasını düzenleyin veFREEPIK_API_KEY
değişkenini kendi API anahtarınızla değiştirin.
Kullanım
- Sunucuyu başlatın:
npm start
- 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:
- Claude Desktop ayarlarına gidin.
mcpServers
bölümüne şu yapılandırmayı ekleyin:
"mcpServers": {
"freepik": {
"command": "node",
"args": ["indirdiğiniz/konum/freepik-mcp-server/index.js"]
}
}
- 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
-
Basit bir görsel oluşturma:
@freepik Bana bir kedi görseli oluştur
-
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor

Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.

Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.