homemade-playwright-mcp-server

fgulen/homemade-playwright-mcp-server

3.2

If you are the rightful owner of homemade-playwright-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Playwright MCP Server is a secure, local-only server for browser automation using the Model Context Protocol.

Tools
5
Resources
0
Prompts
0

Playwright MCP Server

Güvenli bir şekilde local'de çalışan Playwright tabanlı MCP (Model Context Protocol) server.

Özellikler

  • 🔒 Tamamen Local: Tüm işlemler local'de çalışır, internet bağlantısı gerektirmez
  • 🎭 Playwright Tabanlı: Güçlü browser otomasyonu
  • 🛡️ Güvenli: Sadece local sistemde çalışır, dış bağlantı yapmaz
  • 🚀 Kullanımı Kolay: MCP protokolü ile entegre

Kurulum

  1. Bağımlılıkları yükleyin:
npm install
  1. Playwright tarayıcılarını yükleyin:
npx playwright install chromium

Kullanım

Server'ı başlatmak için:

npm start

Veya geliştirme modunda (otomatik yeniden başlatma ile):

npm run dev

Mevcut Araçlar (Tools)

Toplam 25 farklı browser otomasyon aracı mevcuttur:

Navigasyon ve Sayfa İşlemleri

1. browser_navigate

Tarayıcıyı belirtilen URL'ye yönlendirir.

  • Parametreler: url (string, zorunlu)
2. browser_go_back

Tarayıcı geçmişinde geri gider.

3. browser_go_forward

Tarayıcı geçmişinde ileri gider.

4. browser_reload

Sayfayı yeniden yükler.

5. browser_get_url

Mevcut sayfanın URL'sini getirir.

6. browser_get_title

Mevcut sayfanın başlığını getirir.

Görüntü ve İçerik İşlemleri

7. browser_screenshot

Sayfanın ekran görüntüsünü alır.

  • Parametreler:
    • path (string, zorunlu)
    • fullPage (boolean, opsiyonel)
8. browser_get_content

Sayfanın HTML içeriğini getirir.

  • Parametreler: selector (string, opsiyonel)
9. browser_get_text

Bir elementin text içeriğini getirir.

  • Parametreler: selector (string, zorunlu)
10. browser_get_all_text

Sayfadaki tüm görünür metni getirir.

11. browser_get_attribute

Bir elementin attribute değerini getirir.

  • Parametreler:
    • selector (string, zorunlu)
    • attribute (string, zorunlu)

Mouse İşlemleri

12. browser_click

Sayfadaki bir elemana tıklar.

  • Parametreler: selector (string, zorunlu)
13. browser_double_click

Bir elemente çift tıklar.

  • Parametreler: selector (string, zorunlu)
14. browser_right_click

Bir elemente sağ tıklar (context menu).

  • Parametreler: selector (string, zorunlu)
15. browser_hover

Bir elementin üzerine mouse ile gelir.

  • Parametreler: selector (string, zorunlu)

Form İşlemleri

16. browser_fill

Bir input alanını doldurur.

  • Parametreler:
    • selector (string, zorunlu)
    • text (string, zorunlu)
17. browser_select

Dropdown menüden seçim yapar.

  • Parametreler:
    • selector (string, zorunlu)
    • value (string, zorunlu)
18. browser_check

Checkbox veya radio button'ı işaretler.

  • Parametreler: selector (string, zorunlu)
19. browser_uncheck

Checkbox işaretini kaldırır.

  • Parametreler: selector (string, zorunlu)
20. browser_press_key

Klavye tuşuna basar.

  • Parametreler: key (string, zorunlu - örn: Enter, Escape, ArrowDown)

Scroll ve Görünürlük

21. browser_scroll

Sayfayı scroll eder.

  • Parametreler:
    • selector (string, opsiyonel)
    • x (number, opsiyonel)
    • y (number, opsiyonel)
22. browser_is_visible

Bir elementin görünür olup olmadığını kontrol eder.

  • Parametreler: selector (string, zorunlu)

JavaScript ve Beklemeler

23. browser_evaluate

Sayfada JavaScript kodu çalıştırır.

  • Parametreler: script (string, zorunlu)
24. browser_wait

Belirtilen süre kadar veya bir element görünene kadar bekler.

  • Parametreler:
    • selector (string, opsiyonel)
    • timeout (number, opsiyonel, varsayılan: 30000ms)

Tarayıcı Yönetimi

25. browser_close

Tarayıcıyı kapatır.

MCP Client Konfigürasyonu

Claude Desktop veya başka bir MCP client kullanıyorsanız, config dosyanıza ekleyin:

{
  "mcpServers": {
    "playwright": {
      "command": "node",
      "args": ["c:\\Users\\fg\\Desktop\\mcp\\index.js"]
    }
  }
}

Güvenlik

  • Server sadece local'de çalışır (stdio transport kullanır)
  • Dış ağ bağlantısı gerektirmez
  • Tüm browser işlemleri local makinede gerçekleşir
  • Headless mode yerine normal mode kullanır (daha güvenli ve görsel)

Lisans

MIT