chatgpt-web-mcp

ChatGPT hesabınla görsel üreten, düzenleyen ve aynı sohbet içinde yineleyen bir MCP sunucusu. OpenAI API'si yerine giriş yapılmış ChatGPT web oturumunu Playwright ile sürer. Streamable HTTP ve stdio konuşur, Docker imajıyla gelir ve Obot MCP Gateway üzerinde konteyner olarak çalışacak şekilde hazırlanmıştır.

Neler yapabilir

Ayrıca her görsel image://<id> MCP kaynağı olarak okunabilir. image_brief istemi kaba bir fikri ayrıntılı bir görsel istemine çevirir.

Sonuç biçimi: Araçlar görseli satır içi (image içeriği), resource_link ve JSON özet olarak döndürür. PUBLIC_BASE_URL tanımlıysa imzalı ve süreli bir indirme bağlantısı da eklenir.

Uzun işler: Bir görsel genelde 30 ile 120 saniye sürer. Araç SYNC_WAIT_SECONDS kadar bekler ve bu sırada MCP ilerleme bildirimleri gönderir. İş daha uzun sürerse bir job_id döner. İstemci sonucu get_job ile alır. wait: false ile iş hemen arka plana atılır.

Related MCP server: OpenAI GPT-Image MCP Server

Nasıl çalışır

MCP istemcisi ── Streamable HTTP (/mcp) ya da stdio ──► chatgpt-web-mcp
                                                         │  iş kuyruğu (tek sıra)
                                                         ▼
                                       Chromium (Xvfb üzerinde, Playwright)
                                                         │  oturum çerezlerin
                                                         ▼
                                                    chatgpt.com
                                                         │
                     görsel kimlik doğrulamalı fetch ile indirilir ──► /data/outputs + kütüphane

Sunucu istemi ChatGPT'nin giriş kutusuna yazar, gönderir ve asistanın cevabındaki yeni görselleri bekler. ChatGPT işlerken gösterdiği bulanık ön izlemeyi atlar, durdur düğmesi kaybolup görsel sabitlenince indirir. Asistan görsel yerine metinle cevap verirse (içerik reddi, kullanım limiti, soru) bunu CONTENT_REFUSED, RATE_LIMITED ya da NO_IMAGE_RETURNED hatasına çevirir ve sohbet kimliğini döndürür.

Hızlı başlangıç

1. ChatGPT oturumunu dışa aktar

Kendi bilgisayarında (Chrome kurulu olmalı):

git clone https://github.com/UmutKDev/chatgpt-web-mcp.git
cd chatgpt-web-mcp
npm install
npm run export-session

Açılan ayrı bir tarayıcı profilinde ChatGPT'ye giriş yap. Giriş kutusu görününce betik chatgpt-session.json dosyasını yazar ve ekrana tek satırlık bir base64 değer basar. Bu değer CHATGPT_SESSION_STATE olarak kullanılır. Bir şifre gibi sakla ve repoya koyma.

Daha kısa bir yol olarak tarayıcının geliştirici araçlarından __Secure-next-auth.session-token çerezinin değerini CHATGPT_SESSION_TOKEN olarak verebilirsin. Tam oturum (Cloudflare çerezleri dahil) daha az doğrulama ekranına takılır.

2. Docker ile çalıştır

docker run --rm -p 8099:8099 --shm-size=1g \
  -e CHATGPT_SESSION_STATE="$(base64 -w0 chatgpt-session.json)" \
  -e MCP_AUTH_TOKEN=degistir \
  -v chatgpt-data:/data \
  ghcr.io/umutkdev/chatgpt-web-mcp:latest

ya da docker compose up -d (değerleri .env dosyasından okur).

3. MCP istemcisine bağla

HTTP (Claude Code örneği):

claude mcp add --transport http chatgpt-image http://localhost:8099/mcp \
  --header "Authorization: Bearer degistir"

stdio (yerel, Docker olmadan):

{
  "mcpServers": {
    "chatgpt-image": {
      "command": "npx",
      "args": ["-y", "github:UmutKDev/chatgpt-web-mcp", "--stdio"],
      "env": { "CHATGPT_SESSION_STATE": "/mutlak/yol/chatgpt-session.json", "HEADLESS": "false" }
    }
  }
}

Obot'a yayına alma

Obot, üretim için konteyner çalışma zamanını önerir. Konteynerin Streamable HTTP sunması, kataloğa da imaj, port ve yolun yazılması gerekir. Bu repo bunların hepsini hazır getirir.

1. İmajı yayımla. main'e her push ve her v* etiketi .github/workflows/docker.yml ile ghcr.io/umutkdev/chatgpt-web-mcp imajını amd64 ve arm64 için üretir. GHCR paketini Obot'un çekebilmesi için public yap ya da Obot'a registry erişimi ver. Üretimde imajı digest ile sabitle.

2. Katalog girdisini ekle. İki yol var:

   • GitOps: Obot'ta MCP Servers → Catalog sources altına bu reponun URL'sini ekle. Katalog dosyası obot/chatgpt-web-image.yaml içinde. Kök dizindeki .obotcatalogs yalnız bu klasörü okutur.

   • Arayüzden: Add MCP Server → Hosted Server → Containerized seç. Image ghcr.io/umutkdev/chatgpt-web-mcp:0.1.0, Port 8099, Path /mcp gir. CHATGPT_SESSION_STATE ve CHATGPT_SESSION_TOKEN alanlarını Sensitive olarak tanımla.

3. Kullanıcı türü. Girdi serverUserType: singleUser olarak gelir. Her kullanıcı kendi konteynerini ve kendi ChatGPT oturumunu alır. Böylece kuyruklar ve hesap limitleri birbirine karışmaz. Tek bir paylaşılan hesap istiyorsan girdiyi multiUser yap ve oturumu sunucu düzeyinde ver.

4. vMCP'ye ekle. Girdiyi bir vMCP'ye eklerken oturum alanları için Provided at connection seç. Her kullanıcı bağlanırken kendi değerini girer.

5. Kaynaklar. Chromium için en az 1 GiB bellek gerekir. Katalog girdisi 500m CPU ve 1 GiB bellek ister, 2 CPU ve 3 GiB bellekle sınırlar.

Obot konteyneri yeniden başlatırsa /data silinebilir. Oturum yine env değerinden açılır. Ancak kütüphanedeki görseller ve profiller kaybolur. Kalıcı olmaları gerekiyorsa bağımsız Kubernetes kurulumunu (deploy/kubernetes) PVC ile kullan ve Obot'a remote sunucu olarak ekle.

Yapılandırma

Sorun giderme

Geliştirme

npm install
npx playwright-core install chromium   # testler için
npm run typecheck
npm test            # birim testleri + sahte ChatGPT sayfasına karşı uçtan uca testler
npm run mock        # sahte ChatGPT'yi 8787'de elle denemek için

Uçtan uca testler test/mock/server.ts içindeki sahte ChatGPT sayfasına karşı çalışır. Bu sayfa giriş kutusunu, gönder ve durdur düğmelerini, dosya yüklemeyi, bulanık ön izlemeyi, /c/<id> sohbet adreslerini ve çerezle korunan görsel indirmeyi taklit eder. Gerçek chatgpt.com'a karşı otomatik test yoktur, çünkü hesap ve kota gerektirir.

Güvenlik

• Tarayıcı yalnız https://chatgpt.com adresine yönlendirilir. Test dışında başka bir adres reddedilir.

• Oturum çerezleri loglara ve araç çıktılarına yazılmaz. Kalıcı oturum dosyası 0600 izinle saklanır.

• URL girdileri özel ve yerel ağ adreslerine gidemez. Yerel dosyalar yalnız ALLOWED_INPUT_DIRS içinden okunur ve sembolik bağlantılar çözülerek kontrol edilir.

• İndirme bağlantıları HMAC ile imzalanır ve 7 gün sonra geçersiz olur.

• Konteyner root olmayan node kullanıcısıyla çalışır. İmajda yalnız Chromium, Xvfb ve az sayıda font var.

Esinlenilen projeler

Tasarım; leixyou/chatgpt-web-image-mcp, lownamlee/gpt-image-2-mcp, nothariharan/image-gen, Borys520/gpt-image-2-mcp ve strato-space/media-gen-mcp projelerinin incelenmesiyle şekillendi. Karşılaştırma için docs/research.md dosyasına bak.

Lisans

MIT