⚠️ PROJE SONLANDIRILMIŞTIR ⚠️

Bu proje durdurulmuştur. Yeni bir şey inşa ediyoruz withrefresh.com

---

🚀 operative.sh web-eval-agent MCP Server

Kodlama aracısının kendisini hata ayıklamasını sağla, senin daha önemli işlerin var.

🔥 Hata Ayıklamayı Güçlendir

operative.sh'un MCP Server'ı, tarayıcı kullanımı destekli bir aracıyı başlatarak web uygulamalarını doğrudan kod editöründe otonom olarak çalıştırmanızı ve hata ayıklamanızı sağlar.

⚡ Özellikler

• 🌐 Web uygulamanızda gezinin - BrowserUse kullanarak (operative backend ile 2x daha hızlı)
• 📊 Ağ trafiğini yakalayın - istekler akıllıca filtrelenerek bağlam penceresine döndürülür
• 🚨 Konsol hatalarını toplayın - logları ve hataları yakalar
• 🤖 Otonom hata ayıklama - Cursor aracısı, yazdığı kodun end-to-end olarak beklendiği gibi çalışıp çalışmadığını test etmek için web QA aracısı mcp server'ını çağırır.

🧰 MCP Tool Referansı

Tool	Amaç
web_eval_agent	🤖 Tarayıcıyı yönlendiren, ekran görüntüleri, konsol ve ağ loglarını yakalayan ve zengin UX raporu döndüren otomatik UX değerlendirici.
setup_browser_state	🔒 Etkileşimli (headless olmayan) bir tarayıcı açar, böylece bir kez oturum açabilir; kaydedilen çerezler/local-storage sonraki web_eval_agent çalıştırmalarında yeniden kullanılır.

Önemli argümanlar

• web_eval_agent

  • url (gerekli) – çalışan uygulamanın adresi (ör. http://localhost:3000)
  • task (gerekli) – neyi test edeceğinizin doğal dil tanımı ("kayıt akışını tamamlayın ve UX sorunlarını not edin")
  • headless_browser (opsiyonel, varsayılan false) – tarayıcı penceresini gizlemek için true olarak ayarlayın

• setup_browser_state

  • url (opsiyonel) – önce açılacak sayfa (login ekranına doğrudan gitmek için kullanışlı)

Bu araçları doğrudan IDE sohbetinizden tetikleyebilirsiniz, örneğin:

Evaluate my app at http://localhost:3000 – run web_eval_agent with the task "Try the full signup flow and report UX issues".

🏁 Hızlı Başlangıç

Tek Tıkla Entegrasyon ile Kolay Kurulum

1. API anahtarınızı alın (ücretsiz) - API anahtarınızı oluştururken şunu göreceksiniz:
   • Anında Cursor yüklemesi için deeplink ile "Add to Cursor" düğmesi
   • API anahtarınız otomatik olarak dahil edilen Önceden doldurulmuş Claude Code komutu

Manuel Kurulum (macOS/Linux)

1. Ön koşullar (genellikle gerekli değildir):

• brew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• npm: (brew install npm)
• jq: brew install jq

2. API anahtarı aldıktan sonra (ücretsiz) yükleyiciyi çalıştırın
   • playwright yükler
   • uv'yi yükler
   • Kod editörünüz (Cursor/Cline/Windsurf) için JSON ekler!

curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

3. Favori IDE'nizi ziyaret edin ve değişiklikleri uygulamak için yeniden başlatın
4. Sohbet modunda web eval agent tool'unu çağırmak için bir prompt gönderin! örneğin

Test my app on http://localhost:3000. Use web-eval-agent.

🛠️ Manuel Kurulum

1. operative.sh/mcp adresinden API anahtarınızı alın
2. uv'yi yükleyin

curl -LsSf https://astral.sh/uv/install.sh | sh

3. UV yükledikten sonra ortam değişkenlerini kaynak alın

Mac

source ~/.zshrc

Linux

source ~/.bashrc 

4. Playwright'ı yükleyin:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

5. Aşağıdaki JSON'ı ilgili kod editörünüze API anahtarı ile ekleyin
6. Kod editörünüzü yeniden başlatın

🔃 Güncelleme

• uv cache clean
• MCP server'ı yenile

    "web-eval-agent": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "webEvalAgent",
        "--from",
        "git+https://github.com/Operative-Sh/web-eval-agent.git",
        "webEvalAgent"
      ],
      "env": {
        "OPERATIVE_API_KEY": "<YOUR_KEY>"
      }
    }

Operative Discord Server

🛠️ Manuel Kurulum (Mac + Cursor/Cline/Windsurf)

1. operative.sh/mcp adresinden API anahtarınızı alın
2. uv'yi yükleyin

curl -LsSf https://astral.sh/uv/install.sh | sh)

3. Playwright'ı yükleyin:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

4. Aşağıdaki JSON'ı ilgili kod editörünüze API anahtarı ile ekleyin
5. Kod editörünüzü yeniden başlatın

Manuel Kurulum (Windows + Cursor/Cline/Windsurf)

Bunu geliştiriyoruz, herhangi bir sorunla karşılaşırsanız lütfen bir issue açın!

1. Bunu kod editörünüzün terminalinde yapın
2. curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh
3. operative.sh/mcp adresinden API anahtarınızı alın
4. uv yükleyin (curl -LsSf https://astral.sh/uv/install.sh | sh)
5. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
6. Kod editörünüzü yeniden başlatın

🚨 Sorunlar

• Güncellemeler kod editörlerine ulaşmıyor, en son sürüm için güncelleyin veya yeniden yükleyin: En son sürüm için uv cache clean çalıştırın
• Herhangi bir sorun varsa bu repo'da veya discord'da bir Issue açmaktan çekinmeyin!
• 5/5 - değişiklikleri olmayan statik uygulamalar screencasting yapılmıyordu, düzeltildi! Düzeltmeyi almak için uv clean + yeniden başlat

Changelog

• 4/29 - Agent overlay güncellemesi - tarayıcıda aracı çalıştırmasını duraklat/oynat/durdur

📋 Örnek MCP Server Çıktı Raporu

📊 Web Evaluation Report for http://localhost:5173 complete!
📝 Task: Test the API-key deletion flow by navigating to the API Keys section, deleting a key, and judging the UX.

🔍 Agent Steps
  📍 1. Navigate → http://localhost:5173
  📍 2. Click     "Login"        (button index 2)
  📍 3. Click     "API Keys"     (button index 4)
  📍 4. Click     "Create Key"   (button index 9)
  📍 5. Type      "Test API Key" (input index 2)
  📍 6. Click     "Done"         (button index 3)
  📍 7. Click     "Delete"       (button index 10)
  📍 8. Click     "Delete"       (confirm index 3)
🏁 Flow tested successfully – UX felt smooth and intuitive.

🖥️ Console Logs (10)
  1. [debug] [vite] connecting…
  2. [debug] [vite] connected.
  3. [info]  Download the React DevTools …
     …

🌐 Network Requests (10)
  1. GET /src/pages/SleepingMasks.tsx                   304
  2. GET /src/pages/MCPRegistryRegistry.tsx             304
     …

⏱️ Chronological Timeline
  01:16:23.293 🖥️ Console [debug] [vite] connecting…
  01:16:23.303 🖥️ Console [debug] [vite] connected.
  01:16:23.312 ➡️ GET /src/pages/SleepingMasks.tsx
  01:16:23.318 ⬅️ 304 /src/pages/SleepingMasks.tsx
     …
  01:17:45.038 🤖 🏁 Flow finished – deletion verified
  01:17:47.038 🤖 📋 Conclusion repeated above
👁️  See the "Operative Control Center" dashboard for live logs.

Yıldız Geçmişi

---

<3 ile operative.sh tarafından yapılmıştır