Chrome DevTools MCP

Aracılar için Chrome DevTools

Aracılar için Chrome DevTools (chrome-devtools-mcp), kodlama aracınızın (Antigravity, Claude, Cursor veya Copilot gibi) canlı bir Chrome tarayıcısını kontrol etmesine ve incelemesine olanak tanır. Model-Context-Protocol (MCP) sunucusu olarak çalışır ve yapay zeka kodlama asistanınıza güvenilir otomasyon, derinlemesine hata ayıklama ve performans analizi için Chrome DevTools'un tüm gücüne erişim sağlar. MCP olmadan kullanım için bir CLI de sağlanmıştır.

Araç referansı | Değişiklik günlüğü | Katkıda bulunma | Sorun giderme | Tasarım İlkeleri

Temel özellikler

• Performans içgörüleri edinin: İzlemeleri kaydetmek ve uygulanabilir performans içgörüleri çıkarmak için https://github.com/ChromeDevTools/devtools-frontend kullanır.
• Gelişmiş tarayıcı hata ayıklama: Ağ isteklerini analiz edin, ekran görüntüleri alın ve tarayıcı konsol mesajlarını (kaynak eşlemeli yığın izleriyle) kontrol edin.
• Güvenilir otomasyon: Chrome'da eylemleri otomatikleştirmek ve eylem sonuçlarını otomatik olarak beklemek için puppeteer kullanır.

Sorumluluk reddi beyanları

chrome-devtools-mcp, tarayıcı örneğinin içeriğini MCP istemcilerine açığa çıkararak tarayıcıdaki veya DevTools'taki herhangi bir veriyi incelemelerine, hata ayıklamalarına ve değiştirmelerine olanak tanır. MCP istemcileriyle paylaşmak istemediğiniz hassas veya kişisel bilgileri paylaşmaktan kaçının.

chrome-devtools-mcp yalnızca Google Chrome ve Chrome for Testing sürümlerini resmi olarak destekler. Diğer Chromium tabanlı tarayıcılar çalışabilir, ancak bu garanti edilmez ve beklenmeyen davranışlarla karşılaşabilirsiniz. Kendi takdirinize göre kullanın. Extended Stable Chrome sürümünün en son sürümü için düzeltmeler ve destek sağlamaya kararlıyız.

Performans araçları, gerçek kullanıcı deneyimi verilerini almak için izleme URL'lerini Google CrUX API'sine gönderebilir. Bu, laboratuvar verilerinin yanında saha verilerini sunarak bütünsel bir performans resmi sağlamaya yardımcı olur. Bu veriler https://developer.chrome.com/docs/crux tarafından toplanır. Bunu devre dışı bırakmak için --no-performance-crux bayrağıyla çalıştırın.

Kullanım istatistikleri

Google, Chrome DevTools MCP'nin güvenilirliğini ve performansını artırmak için kullanım istatistikleri (araç çağrısı başarı oranları, gecikme süresi ve ortam bilgileri gibi) toplar.

Veri toplama varsayılan olarak etkindir. Sunucuyu başlatırken --no-usage-statistics bayrağını geçerek devre dışı bırakabilirsiniz:

"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Google bu verileri Google Gizlilik Politikası uyarınca işler.

Google'ın Chrome DevTools MCP için kullanım istatistikleri toplaması, Chrome tarayıcısının kullanım istatistiklerinden bağımsızdır. Chrome metriklerinden çıkmak sizi otomatik olarak bu araçtan çıkarmaz ve bunun tersi de geçerlidir.

CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS veya CI ortam değişkenleri ayarlanmışsa toplama devre dışı bırakılır.

Güncelleme kontrolleri

Varsayılan olarak sunucu, npm kayıt defterini periyodik olarak güncellemeler için kontrol eder ve daha yeni bir sürüm mevcut olduğunda bir bildirim günlüğe kaydeder. Bu güncelleme kontrollerini CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS ortam değişkenini ayarlayarak devre dışı bırakabilirsiniz.

Gereksinimler

• Node.js LTS sürümü.
• Chrome güncel kararlı sürümü veya daha yenisi.
• npm

Başlarken

MCP istemcinize aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

[!NOTE] chrome-devtools-mcp@latest kullanmak, MCP istemcinizin her zaman Chrome DevTools MCP sunucusunun en son sürümünü kullanmasını sağlar.

Yalnızca temel tarayıcı görevleriyle ilgileniyorsanız, --slim modunu kullanın:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest", "--slim", "--headless"]
    }
  }
}

Slim araç referansına bakın.

MCP İstemci yapılandırması

Düzenleyicinize veya aracınıza (ör. Antigravity, Claude Code, Cursor, VS Code) özel kurulum talimatları için İstemci Yapılandırma Kılavuzumuza bakın.

İlk komutunuz

Her şeyin çalışıp çalışmadığını kontrol etmek için MCP İstemcinize aşağıdaki komutu girin:

Check the performance of https://developers.chrome.com

MCP istemciniz tarayıcıyı açmalı ve bir performans izlemesi kaydetmelidir.

[!NOTE] MCP sunucusu, MCP istemcisi çalışan bir tarayıcı örneği gerektiren bir araç kullandığında tarayıcıyı otomatik olarak başlatır. Chrome DevTools MCP sunucusuna tek başına bağlanmak tarayıcıyı otomatik olarak başlatmaz.

Araçlar

Herhangi bir sorunla karşılaşırsanız sorun giderme kılavuzumuza göz atın. Desteklenen tüm MCP yeteneklerinin tam listesi için Araç Referansına bakın.

Yapılandırma

Sunucu parametrelerinin (ör. --headless, --isolated, --slim) tam listesini ve WebSocket bağlantılarının nasıl yapılandırılacağını Yapılandırma Kılavuzunda bulabilirsiniz.

Gelişmiş Kullanım

Eşzamanlı oturumları işleme, kalıcı kullanıcı veri dizinleri, yeni bir tane başlatmak yerine çalışan bir Chrome örneğine bağlanma veya Android'de hata ayıklama gibi gelişmiş özellikler için Gelişmiş Kullanım Kılavuzumuza bakın.

Tarayıcı alt aracısı olarak entegrasyon

Aracı odaklı araçlar geliştiriyorsanız ve ürününüzün bir parçası olarak entegre bir tarayıcı alt aracısı sağlamak istiyorsanız, aracılar için Chrome DevTools üzerine inşa etmenizi öneririz.

Referans uygulaması için Gemini CLI tarayıcı aracısı belgelerine bakın.