browser-use-mcp-server

Ön Koşullar

• uv - Hızlı Python paket yöneticisi
• Playwright - Tarayıcı otomasyonu
• mcp-proxy - stdio modu için gerekli

# Ön koşulları yükleyin
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install mcp-proxy
uv tool update-shell

Ortam Değişkenleri

.env dosyası oluşturun:

OPENAI_API_KEY=your-api-key
CHROME_PATH=optional/path/to/chrome
PATIENT=false  # API çağrıları görev tamamlanmasını beklemelidir ayarını true yapın

Kurulum

# Bağımlılıkları yükleyin
uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium

Kullanım

SSE Modu

# Kaynaktan doğrudan çalıştırın
uv run server --port 8000

stdio Modu

# 1. Oluşturun ve genel olarak yükleyin
uv build
uv tool uninstall browser-use-mcp-server 2>/dev/null || true
uv tool install dist/browser_use_mcp_server-*.whl

# 2. stdio aktarımı ile çalıştırın
browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000

İstemci Yapılandırması

SSE Modu İstemci Yapılandırması

{
  "mcpServers": {
    "browser-use-mcp-server": {
      "url": "http://localhost:8000/sse"
    }
  }
}

stdio Modu İstemci Yapılandırması

{
  "mcpServers": {
    "browser-server": {
      "command": "browser-use-mcp-server",
      "args": [
        "run",
        "server",
        "--port",
        "8000",
        "--stdio",
        "--proxy-port",
        "9000"
      ],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

Yapılandırma Konumları

İstemci	Yapılandırma Yolu
Cursor	./.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Claude (Mac)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude (Windows)	%APPDATA%\Claude\claude_desktop_config.json

Özellikler

• [x] Tarayıcı Otomasyonu: AI ajanları aracılığıyla tarayıcıları kontrol etme
• [x] Çift Aktarım: SSE ve stdio protokollerinin her ikisini de destekleme
• [x] VNC Akışı: Tarayıcı otomasyonunu gerçek zamanlı izleme
• [x] Async Görevler: Tarayıcı işlemlerini asenkron olarak yürütme

Yerel Geliştirme

Paketi yerel olarak geliştirmek ve test etmek için:

1. Dağıtılabilir bir wheel oluşturun:

   # Proje kök dizininden
   uv build
   

2. Bunu genel bir araç olarak yükleyin:

   uv tool uninstall browser-use-mcp-server 2>/dev/null || true
   uv tool install dist/browser_use_mcp_server-*.whl
   

3. Herhangi bir dizinden çalıştırın:

   # Geçerli oturum için OpenAI API anahtarınızı ayarlayın
   export OPENAI_API_KEY=your-api-key-here
   
   # Veya tek seferlik bir çalıştırma için satır içi sağlayın
   OPENAI_API_KEY=your-api-key-here browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
   

4. Değişiklik yaptıktan sonra, yeniden oluşturun ve yeniden yükleyin:

   uv build
   uv tool uninstall browser-use-mcp-server
   uv tool install dist/browser_use_mcp_server-*.whl
   

Docker

Docker kullanmak, sunucuyu çalıştırmak için tutarlı ve izole bir ortam sağlar.

# Docker imajını oluşturun
docker build -t browser-use-mcp-server .

# Konteyner'i varsayılan VNC şifresi ("browser-use") ile çalıştırın
# --rm, konteyner durdurulduğunda otomatik olarak kaldırılmasını sağlar
# -p 8000:8000 sunucu portunu eşler
# -p 5900:5900 VNC portunu eşler
docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server

# Dosyadan okunan özel bir VNC şifresi ile çalıştırın
# Dosya oluşturun (ör. vnc_password.txt) sadece istediğiniz şifreyi içeren
echo "your-secure-password" > vnc_password.txt
# Şifre dosyasını konteyner içinde gizli olarak bağlayın
docker run --rm -p8000:8000 -p5900:5900 \
  -v $(pwd)/vnc_password.txt:/run/secrets/vnc_password:ro \
  browser-use-mcp-server

Not: Birim bağlantısında (./-v) :ro bayrağı, arttırılmış güvenlik için şifre dosyasını konteyner içinde salt okunur yapar.

VNC Viewer

# Tarayıcı tabanlı viewer
git clone https://github.com/novnc/noVNC
cd noVNC
./utils/novnc_proxy --vnc localhost:5900

Varsayılan şifre: browser-use (özel şifre yöntemi kullanılarak geçersiz kılınmadığı sürece)

Örnek

AI'dan şu şekilde talep edin:

https://news.ycombinator.com adresini aç ve en yüksek dereceli makaleyi döndür

Destek

Sorunlar veya sorularınız için: cobrowser.xyz

Star Geçmişi