본문으로 건너뛰기
MCP 서버 전체 목록

Chrome DevTools MCP

  • 추천0
  • GitHub 별57K
  • 개발라이선스Apache-2.0

코딩 에이전트가 실제 크롬을 조작 · 점검해요. 성능 트레이스, 네트워크, 콘솔, 스크린샷을 크롬 개발자 도구로 분석해요

원본:ChromeDevTools/chrome-devtools-mcp

설치 방법은 설치 탭에 정리했어요.

설명

에이전트를 위한 Chrome DevTools

npm chrome-devtools-mcp package

에이전트를 위한 Chrome DevTools(chrome-devtools-mcp)는 코딩 에이전트(Antigravity, Claude, Cursor, Copilot 등)가 실제로 켜진 Chrome 브라우저를 제어하고 살펴볼 수 있게 해 줘요. 모델 컨텍스트 프로토콜(MCP) 서버와 CLI로 쓸 수 있어요. 둘 다 AI 코딩 어시스턴트에게 믿을 수 있는 자동화, 깊이 있는 디버깅, 성능 분석을 위한 Chrome DevTools의 모든 힘을 줘요.

도구 참조 | CLI | 스킬 | 변경 기록 | 기여하기 | 문제 해결 | 설계 원칙

주요 기능

  • 성능 인사이트 얻기: Chrome DevTools로 트레이스를 기록하고, 실행에 옮길 수 있는 성능 인사이트를 뽑아요.
  • 고급 브라우저 디버깅: 네트워크 요청을 분석하고, 스크린샷을 찍고, 브라우저 콘솔 메시지를 확인해요(소스 맵이 적용된 스택 트레이스 포함).
  • 믿을 수 있는 자동화: puppeteer로 Chrome의 동작을 자동화하고, 동작 결과를 자동으로 기다려요.

면책 사항

chrome-devtools-mcp는 브라우저 인스턴스의 내용을 MCP 클라이언트에 노출해서, 클라이언트가 브라우저나 DevTools의 모든 데이터를 살펴보고 디버깅하고 바꿀 수 있게 해요. MCP 클라이언트와 나누고 싶지 않은 민감한 정보나 개인 정보는 공유하지 마세요.

chrome-devtools-mcp는 Google Chrome과 Chrome for Testing만 공식 지원해요. 다른 Chromium 기반 브라우저도 될 수 있지만 보장하지 않으며, 예상치 못한 동작이 생길 수 있어요. 쓸지 말지는 스스로 판단하세요. Extended Stable Chrome의 최신 버전에 대해서는 수정과 지원을 약속해요.

성능 도구는 트레이스 URL을 Google CrUX API에 보내 실제 사용자 경험 데이터를 가져올 수 있어요. 실험실 데이터와 함께 현장 데이터를 보여 줘서 성능을 입체적으로 보게 해 줘요. 이 데이터는 Chrome 사용자 경험 보고서(CrUX)가 수집해요. 끄려면 --no-performance-crux 플래그를 붙여 실행하세요.

사용 통계

Google은 Chrome DevTools MCP의 안정성과 성능을 개선하려고 사용 통계(도구 호출 성공률, 지연 시간, 환경 정보 등)를 수집해요.

데이터 수집은 기본으로 켜져 있어요. 서버를 시작할 때 --no-usage-statistics 플래그를 넘기면 거부할 수 있어요.

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

Google은 이 데이터를 Google 개인정보처리방침에 따라 다뤄요.

Chrome DevTools MCP의 사용 통계 수집은 Chrome 브라우저의 사용 통계와 별개예요. Chrome 측정을 거부해도 이 도구의 수집까지 자동으로 거부되지 않고, 반대도 마찬가지예요.

CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS나 CI 환경 변수가 설정돼 있으면 수집이 꺼져요.

업데이트 확인

서버는 기본으로 npm 레지스트리에서 주기적으로 업데이트를 확인하고, 더 새로운 버전이 있으면 알림을 로그에 남겨요. CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS 환경 변수를 설정하면 이 확인을 끌 수 있어요.

요구 사항

시작하기

쓰는 MCP 클라이언트에 아래 설정을 추가하세요.

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

📝 참고 chrome-devtools-mcp@latest를 쓰면 MCP 클라이언트가 항상 최신 버전의 Chrome DevTools MCP 서버를 써요.

MCP 클라이언트 설정

쓰는 편집기나 에이전트(예: Antigravity, Claude Code, Cursor, VS Code)별 설정 방법은 클라이언트 설정 가이드를 보세요.

첫 프롬프트

MCP 클라이언트에 아래 프롬프트를 입력해 모든 게 잘 되는지 확인해 보세요.

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

MCP 클라이언트가 브라우저를 열고 성능 트레이스를 기록해야 해요.

📝 참고 MCP 서버는 MCP 클라이언트가 실행 중인 브라우저 인스턴스가 필요한 도구를 쓸 때 브라우저를 자동으로 시작해요. Chrome DevTools MCP 서버에 연결하는 것만으로는 브라우저가 자동으로 시작되지 않아요.

CLI

이 패키지에는 chrome-devtools CLI도 들어 있어요. MCP 없이 터미널에서 브라우저를 제어할 때 쓰세요.

npm i chrome-devtools-mcp@latest -g
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stop

모든 명령과 옵션은 CLI 가이드를 보세요.

스킬

이 패키지에는 에이전트에게 Chrome DevTools 쓰는 법을 가르치는 스킬이 들어 있어요.

스킬쓰임
chrome-devtoolsMCP 도구로 페이지를 디버깅하고 자동화해요.
chrome-devtools-cliCLI를 실행하고 그것으로 셸 스크립트를 써요.
a11y-debugging접근성 문제를 점검하고 고쳐요.
cookie-debugging쿠키, 세션, 인증을 디버깅해요.
debug-optimize-lcp최대 콘텐츠풀 페인트(LCP)를 디버깅하고 개선해요.
memory-leak-debugging메모리 누수를 찾아 고쳐요.
troubleshootingMCP와 Chrome 사이의 연결 문제를 고쳐요.

스킬을 플러그인으로 설치하기

플러그인은 MCP 서버와 CLI 스킬을 포함한 모든 스킬을 설치해요.

  • Claude Code: /plugin marketplace add ChromeDevTools/chrome-devtools-mcp를 실행한 뒤 /plugin install chrome-devtools-mcp@chrome-devtools-plugins를 실행하세요.
  • Copilot / VS Code: Chat: Install Plugin From Source를 실행하고 ChromeDevTools/chrome-devtools-mcp를 입력하세요.
  • Gemini CLI: gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp를 실행하세요.

더 자세한 내용은 클라이언트 설정 가이드를 보세요.

스킬을 직접 설치하기

에이전트가 플러그인을 지원하지 않으면, 스킬 폴더를 에이전트의 스킬 디렉터리로 복사하세요. 스킬은 npm 패키지 안에 들어 있어요.

npm i chrome-devtools-mcp@latest -g
# Claude Code 예시입니다. 쓰는 에이전트의 스킬 디렉터리를 쓰세요.
mkdir -p ~/.claude/skills
cp -R "$(npm root -g)/chrome-devtools-mcp/skills/chrome-devtools-cli" ~/.claude/skills/

⚠️ 중요 chrome-devtools-cli 스킬은 CLI가 필요해요. 스킬을 쓰기 전에 패키지를 전역으로 설치하세요.

스킬을 최신으로 유지하기

스킬은 특정 버전의 도구를 설명해요. MCP 서버나 CLI를 업데이트할 때마다 스킬도 업데이트하세요. 오래된 스킬은 에이전트에게 바뀐 도구나 매개변수를 쓰라고 알려 줄 수 있어요.

  • 플러그인: 쓰는 에이전트의 플러그인 관리자가 가진 업데이트 명령을 쓰세요. 위의 Gemini CLI 명령은 --auto-update로 자동 업데이트를 켜요.
  • 직접 설치: 패키지를 업데이트한 뒤 스킬 폴더를 다시 복사하세요.
npm i chrome-devtools-mcp@latest -g
mkdir -p ~/.claude/skills
cp -R "$(npm root -g)/chrome-devtools-mcp/skills/chrome-devtools-cli" ~/.claude/skills/

도구

문제가 생기면 문제 해결 가이드를 확인하세요. 지원하는 모든 MCP 기능의 전체 목록은 도구 참조를 보세요.

설정

서버 매개변수(예: --headless, --isolated, --slim)의 전체 목록과 WebSocket 연결을 설정하는 방법은 설정 가이드에 있어요.

기본적인 브라우저 작업만 필요하다면, --slim 플래그가 줄인 도구 모음만 제공해요. 슬림 도구 참조를 보세요.

고급 사용법

동시 세션 다루기, 사용자 데이터 디렉터리 유지, 사용자 지정 또는 표준이 아닌 브라우저 경로(--executablePath), 새로 시작하는 대신 실행 중인 Chrome 인스턴스에 연결하기, 안드로이드에서 디버깅하기 같은 고급 기능은 고급 사용법 가이드를 보세요.

브라우저 서브에이전트로 통합하기

에이전트 도구를 개발하면서 제품의 일부로 통합된 브라우저 서브에이전트를 제공하고 싶다면, 에이전트를 위한 Chrome DevTools 위에 만들기를 권해요.

참조 구현은 Gemini CLI 브라우저 에이전트 문서를 보세요.