openai-gpt-image-mcp

OpenAI'ın GPT-4o/gpt-image-1 görüntü oluşturma ve düzenleme API'leri için Model Context Protocol (MCP) tool server'ı.

Görüntü oluştur: OpenAI'ın en son modellerini kullanarak metin istekleri üzerinden görüntü oluştur.
Görüntüleri düzenle: İleri prompt kontrolü ile görüntüleri düzenle (inpainting, outpainting, compositing).
Destekler: Claude Desktop, Cursor, VSCode, Windsurf ve tüm MCP-uyumlu client'lar.

✨ Özellikler

create-image: İstekten görüntü oluştur, gelişmiş seçenekler ile (boyut, kalite, arka plan, vb).
edit-image: Prompt ve isteğe bağlı mask kullanarak görüntüleri düzenle veya genişlet, dosya yolları ve base64 girişini destekle.
Dosya çıktısı: Oluşturulan görüntüleri doğrudan diske kaydet veya base64 olarak al.

🚀 Kurulum

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git
cd openai-gpt-image-mcp
yarn install
yarn build

🔑 Yapılandırma

Claude Desktop veya VSCode (Cursor/Windsurf dahil) yapılandırmasına ekle:

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

Azure dağıtımlarını da destekler:

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { 
        "AZURE_OPENAI_API_KEY": "sk-...",
        "AZURE_OPENAI_ENDPOINT": "my.endpoint.com",
        "OPENAI_API_VERSION": "2024-12-01-preview"
      }
    }
  }
}

Ayrıca ortam dosyası sağlamayı da destekler:

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js", "--env-file", "./deployment/.env"]
    }
  }
}

⚡ Gelişmiş

create-image için, bir kerede 10'a kadar görüntü oluşturmak için n ayarla.
edit-image için, düzenleme yapılacak yeri kontrol etmek amacıyla mask görüntüsü (dosya yolu veya base64) sağla.
--env-file path/to/file/.env ile ortam dosyası sağla
Tüm seçenekler için src/index.ts bak.

🧑‍💻 Geliştirme

TypeScript kaynağı: src/index.ts
Derleme: yarn build
Çalıştır: node dist/index.js

📝 Lisans

MIT

🩺 Sorun Giderme

OPENAI_API_KEY geçerli olduğundan ve görüntü API erişimine sahip olduğundan emin ol.
Doğrulanmış bir OpenAI organizasyonunuz olması gerekir. Doğrulandıktan sonra, görüntü API erişiminin etkinleşmesi 15–20 dakika sürebilir.
Dosya yolları mutlak olmalıdır.
- Unix/macOS/Linux: / ile başlayan (örn. /path/to/image.png)
- Windows: Sürücü harfi ardından : (örn. C:/path/to/image.png veya C:\path\to\image.png)
Dosya çıktısı için dizinin yazılabilir olduğundan emin ol.
Dosya tipleri hakkında hatalar görürseniz, görüntü dosyasının uzantılarını ve formatlarını kontrol et.

⚠️ Sınırlamalar & Büyük Dosya Yönetimi

1MB Payload Sınırı: MCP client'ları (Claude Desktop dahil) tool yanıtları için 1MB'lık sabit bir sınıra sahiptir. Büyük görüntüler (özellikle yüksek çözünürlük veya birden fazla görüntü) base64 olarak döndürülürse kolayca bu sınırı aşabilir.
Dosya Çıktısına Otomatik Geçiş: Toplam görüntü boyutu 1MB'ı aşarsa, tool otomatik olarak görüntüleri diske kaydedecek ve base64 yerine dosya yolu(ları) döndürecektir. Bu uyumluluğu sağlar ve result exceeds maximum length of 1048576 gibi hatalardan kaçınır.
Varsayılan Dosya Konumu: file_output yolu belirtmezseniz, görüntüler /tmp (veya MCP_HF_WORK_DIR ortam değişkeni tarafından ayarlanan dizin) içine benzersiz bir dosya adıyla kaydedilecektir.
Ortam Değişkeni:
- MCP_HF_WORK_DIR: Büyük görüntülerin ve dosya çıktılarının nereye kaydedileceğini kontrol etmek için bunu ayarla. Örnek: export MCP_HF_WORK_DIR=/your/desired/dir
En İyi Uygulama: Büyük veya üretim görüntüleri için her zaman dosya çıktısı kullan ve client'ının dosya yollarını yönetmek üzere yapılandırıldığından emin ol.

📚 Referanslar

OpenAI Images API Belgeleri

🙏 Teşekkürler

@modelcontextprotocol/sdk ile oluşturuldu
openai Node.js SDK'sı kullanır
SureScale.ai tarafından oluşturuldu
Axle Research and Technology tarafından katkılar

SureScaleAI/openai-gpt-image-mcp

Bu MCP sunucusu hakkında