YetiBrowser MCP

[!IMPORTANT] Bu proje arşivlenmiştir. Claude ve Codex gibi yapay zeka ajanlarındaki tarayıcı kontrolü eksikliğini gidermek için geliştirilmişti, ancak ajanlar artık bu işlevleri özel bir MCP tabanlı çözüme ihtiyaç duymadan yerleşik olarak sunuyor.

YetiBrowser MCP

YetiBrowser MCP, Tarayıcı MCP iş akışının tamamen açık kaynaklı bir uygulamasıdır. Node tabanlı bir MCP sunucusunu Chrome/Firefox uzantılarıyla birleştirerek Model Bağlam Protokolü istemcilerinin (Codex/Claude Code, Cursor, Windsurf, MCP Inspector veya kendi araçlarınız) gerçek bir tarayıcı sekmesini otomatikleştirmesini sağlar; bu sırada her bayt makinenizde kalır ve denetlenebilir.

Neden YetiBrowser MCP'yi seçmelisiniz?

• Şeffaf ve hacklenebilir – blob indirme yok. Her bileşeni inceleyin, çatallayın ve genişletin.
• Yerel öncelikli – uzantı yalnızca bir localhost MCP sunucusuyla iletişim kurar; tarama verileri cihazınızdan asla ayrılmaz.
• Çapraz tarayıcı – paylaşılan mantık hem Chrome hem de Firefox paketlerine güç verir (Firefox yapısı, daha iyi Manifest V3 desteği beklediğinden, Mozilla tam MV3 API'lerini sunana kadar bağlantı kullanıcı deneyimi sınırlı olabilir).
• Geliştirici odaklı araçlar – hata ayıklama ve kalite güvencesi için daha zengin konsol yakalama, DOM farkı alma, sayfa durumu dökümleri ve tam sayfa ekran görüntüleri.
• Üretim dostu – paketleme, yayınlama ve IDE iş akışlarıyla entegrasyon için betikler ve belgeler.

Depo düzeni

• packages/shared – mesajlar ve araç şemaları için paylaşılan TypeScript tanımları.
• packages/server – MCP istemcilerini çalışan bir tarayıcı sekmesine bağlayan MCP sunucusu.
• extensions/shared – paylaşılan uzantı kaynağı (arka plan/açılır pencere) ve varlıklar.
• extensions/chrome / extensions/firefox – tarayıcı başına paketleme katmanları.
• docs/ – çalışma alanı komutları, yayınlama kontrol listeleri ve özellik notları.
• scripts/ – sürüm zip'leri için package-extensions.sh gibi yardımcı araçlar.

Mevcut MCP Araçları

• browser_snapshot – geçerli sayfanın erişilebilirlik odaklı bir anlık görüntüsünü yakala
• browser_snapshot_diff – DOM/ARIA değişikliklerini vurgulamak için en son iki anlık görüntüyü karşılaştır
• browser_navigate – bağlı sekmeye yeni bir URL yükle ve güncellenmiş bir anlık görüntü döndür
• browser_go_back / browser_go_forward – MCP'yi senkronize tutarak geçmişte ilerle
• browser_wait – belirli bir saniye boyunca otomasyonu duraklat
• browser_wait_for – devam etmeden önce bir seçici görünene kadar (isteğe bağlı olarak görünür) bekle
• browser_press_key – odaklanılan öğe üzerinde bir klavye tuş basımını simüle et
• browser_click – bir CSS seçiciyle tanımlanan öğeye tıkla
• browser_hover – işaretçiyi hedeflenen öğenin üzerine getir
• browser_drag – sıralanabilir/sürükle-bırak arayüzleri için bir öğeyi bir bırakma hedefine sürükle
• browser_type – düzenlenebilir bir öğeye metin yaz (isteğe bağlı olarak Enter ile gönder)
• browser_fill_form – tek bir çağrıda birden fazla girdi/seçim/onay kutusu/radyo düğmesini doldur
• browser_select_option – bir <select> öğesinde bir veya daha fazla seçenek belirle
• browser_screenshot – DevTools protokolü aracılığıyla bir görünüm alanı veya tam sayfa ekran görüntüsü yakala
• browser_get_console_logs – yığın izleriyle birlikte hatalar dahil olmak üzere son konsol çıktısını döndür
• browser_page_state – bağlı sayfa için formları, depolama anahtarlarını ve çerezleri dökümle
• browser_connection_info – köprü WebSocket bağlantı noktasını, bağlantı durumunu ve uzantı sürümünü bildir
• browser_evaluate – sayfa içinde özel JavaScript çalıştır ve JSON serileştirilebilir sonuçları döndür
• browser_handle_dialog – isteğe bağlı istem metniyle alert/confirm/prompt iletişim kutularını kabul et veya reddet

MCP Tarayıcı Uzantısı Kurulumu

Chrome Tarayıcı

• En son Chrome Tarayıcı Uzantısını buradan yükleyin: https://chromewebstore.google.com/detail/hpedknkjljpopinabjjmljgckhlancni?utm_source=item-share-cb
• Birden fazla YetiBrowser MCP Sunucusu örneği çalıştırmıyorsanız Otomatik bağlantı modunda bırakın

Firefox Tarayıcı (şu anda mevcut değil)

• Firefox kararlı sürümündeki Manifest v3'ün sınırlı yetenekleri nedeniyle, Firefox uzantısı, tam destek yaygın olarak kullanılabilir olana kadar (Nightly yapıları dışında) beklemeye alınmıştır.

MCP Sunucusu Kurulumu

Codex CLI

• ~/.codex/config.toml dosyanızı düzenleyin ve MCP girişini ekleyin:

  [mcp_servers.yetibrowser-mcp]
  command = "npx"
  args = ["-y", "@yetidevworks/server"]
  

• codex CLI komutunu yeniden başlatın; /mcp araçları altında yetibrowser-mcp listesini görmelisiniz.
• Belirli bir bağlantı noktası sağlamak istiyorsanız, args girişi için şu biçimi kullanın: args = ["-y", "@yetidevworks/server", "--ws-port", "9010"]

Claude Code

• Uzantının yüklü olduğundan ve bir sekmeye bağlı olduğundan emin olun, ardından MCP sunucusunu npx -y @yetidevworks/server ile başlatın (veya yerel olarak oluşturulmuş CLI'yi çalıştırın).
• Sunucu girişini ~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin (örnek için docs/publishing.md bölümüne bakın).
• Yeni MCP sunucusunu alması için claude'i yeniden başlatın; uzantı bağlandığında /mcp araçlar menüsü altında yetibrowser-mcp listesini görmelisiniz.

Diğer MCP uyumlu istemciler

• Herhangi bir MCP istemcisi, CLI'yi (npx -y @yetidevworks/server) başlatarak veya isteğe bağlı olarak belirli bir bağlantı noktası sağlayarak (örn. npx -y @yetidevworks/server --ws-port 9010) bağlanabilir.
• Sunucu, stdio üzerinden standart MCP aktarımını sunar, bu nedenle bir sekme bağlıyken yukarıdaki komutu çalıştırmak için istemcinizin desteklediği yapılandırma mekanizmasını kullanın.

MCP Inspector

• Bir kodlama ajanı dışında test ve hata ayıklama için.
• YetiBrowser MCP tarayıcı uzantısıyla birlikte MCP sunucusunu çalıştırmak ve incelemek için npx @modelcontextprotocol/inspector npx -y @yetidevworks/server -- --ws-port 9010.

Sorun Giderme

• CLI, boş bir tane bulana kadar 9010-9020 bağlantı noktalarını tarar, ilerlediğinde switched to günlüğünü kaydeder. Belirli bir bağlantı noktasını sabitlemek istiyorsanız --ws-port <port> iletin.
• Tarayıcı uzantısı açılır penceresi bu davranışı yansıtır: CLI'nin bağlantı noktasını izlemek için "Otomatik"te bırakın veya "Manuel"i seçip browser_connection_info / CLI günlüğü tarafından bildirilen bağlantı noktasını girerek geçersiz kılın.
• Bağlantı noktası hakkında yapay zeka aracınıza sorun. Örneğin: what is the yetibrowser mcp connction info?, ardından manuel bağlantı noktasını bildirilen bağlantı noktasına ayarlayın.

Belgeler ve derleme betikleri

• Çalışma alanı komutları docs/workspace-commands.md içinde bulunur.
• Yayınlama adımları (npm + uzantı mağazaları) docs/publishing.md içindedir.
• Ekran görüntüsü davranışı docs/screenshot.md içinde belgelenmiştir.
• ./scripts/package-extensions.sh ile dağıtılabilir Chrome/Firefox zip'leri oluşturun (çıktı artifacts/ konumuna).
• Depo düzeyinde bir gizlilik politikası PRIVACY.md içinde mevcuttur.