Chrome DevTools MCP: 코딩 에이전트가 실제 Chrome을 조작하고 디버깅하게 하는 도구

Chrome DevTools MCP는 코딩 에이전트가 실제로 켜진 Chrome을 직접 조작하고 점검하게 해 주는 도구예요. Chrome DevTools 팀이 만들었고, MCP 서버와 명령줄 도구(CLI) 두 가지 형태로 제공돼요. 에이전트가 코드를 고친 뒤 “화면이 정말 그렇게 나오는지”, “느린 이유가 뭔지”를 스스로 확인하게 만드는 게 핵심이에요.

무엇을 해 주나요

README는 기능을 세 가지로 설명해요.

  • 성능 분석: Chrome DevTools로 성능 추적(trace)을 기록하고 개선에 쓸 수 있는 인사이트를 뽑아요. 성능 도구는 추적한 URL을 Google의 CrUX(Chrome 사용자 경험 보고서) API로 보내서 실제 사용자 데이터를 나란히 보여 줄 수 있어요.
  • 브라우저 디버깅: 네트워크 요청 분석, 스크린샷, 콘솔 메시지 확인을 해요. 콘솔 메시지에는 소스맵이 적용된 스택 트레이스가 붙어요.
  • 안정적인 자동화: Puppeteer로 Chrome 안에서 클릭 같은 동작을 수행하고, 동작 결과가 나올 때까지 자동으로 기다려요.

MCP 서버 외에 같은 패키지에 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

함께 들어 있는 스킬

에이전트에게 도구 사용법을 가르치는 스킬이 7개 들어 있어요.

  • chrome-devtools: MCP 도구로 페이지를 디버깅하고 자동화
  • chrome-devtools-cli: CLI 실행과 셸 스크립트 작성 (CLI를 전역 설치해야 해요)
  • a11y-debugging: 접근성 문제 점검과 수정
  • cookie-debugging: 쿠키, 세션, 인증 문제 디버깅
  • debug-optimize-lcp: LCP(가장 큰 콘텐츠 표시 시간) 개선
  • memory-leak-debugging: 메모리 누수 찾기
  • troubleshooting: MCP와 Chrome 사이 연결 문제 해결

스킬은 특정 버전의 도구를 기준으로 쓰여 있어서, 서버나 CLI를 업데이트할 때마다 스킬도 같이 갱신하라고 README가 당부해요. 오래된 스킬이 바뀐 도구나 인자를 쓰라고 시킬 수 있기 때문이에요.

설치와 사용

MCP 클라이언트 설정에 아래 항목을 추가하는 방식이에요. Node.js LTS, 현재 안정판 이상의 Chrome, npm이 필요해요.

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

잘 되는지 보려면 에이전트에게 “https://developers.chrome.com 의 성능을 확인해 줘”라고 시키면 돼요. 브라우저가 열리고 성능 추적이 기록돼요. 브라우저는 도구를 처음 호출할 때 시작되고, MCP 서버에 연결만 해서는 열리지 않아요.

플러그인으로 설치하면 MCP 서버와 스킬을 한 번에 받을 수 있어요. Claude Code에서는 /plugin marketplace add ChromeDevTools/chrome-devtools-mcp 다음에 /plugin install chrome-devtools-mcp@chrome-devtools-plugins를 입력해요. Copilot/VS Code와 Gemini CLI용 설치 방법도 README에 있어요. 기본 작업만 필요하면 --slim 옵션으로 도구 수를 줄일 수 있고, --headless, --isolated 같은 옵션과 실행 중인 Chrome에 연결하는 방법, Android 디버깅은 별도 문서로 안내돼요(이 문서들은 읽지 않았어요).

누구에게 쓸모 있나요

  • 에이전트와 함께 프런트엔드를 만들면서 “고친 결과를 눈으로 확인하는 단계”까지 맡기고 싶은 개발자
  • LCP 개선, 접근성 점검, 메모리 누수 추적처럼 DevTools를 열어서 하던 반복 점검을 에이전트에게 넘기고 싶은 사람
  • 에이전트 제품을 만들면서 브라우저 서브에이전트가 필요한 개발자. README는 이 경우 Chrome DevTools MCP 위에 만들기를 권하고, 참고 구현으로 Gemini CLI의 브라우저 에이전트 문서를 가리켜요.

쓰기 전에 알아 둘 점

  • 브라우저 내용이 에이전트에게 그대로 열려요. README가 “브라우저와 DevTools 안의 어떤 데이터든 에이전트가 살펴보고 바꿀 수 있다”고 경고해요. 로그인된 개인 브라우저에 연결하면 쿠키와 세션도 노출될 수 있으니, 민감한 정보가 없는 별도 프로필이나 테스트용 Chrome을 쓰는 게 안전해요.
  • 사용 통계 수집이 기본으로 켜져 있어요. 도구 호출 성공률, 지연 시간, 환경 정보를 Google이 수집하고, --no-usage-statistics로 끌 수 있어요. 환경 변수 CI가 설정된 환경에서는 자동으로 꺼져요. 이 수집은 Chrome 브라우저의 통계 설정과 별개예요.
  • CrUX 전송: 성능 도구가 추적 URL을 CrUX API로 보낼 수 있어요. 끄려면 --no-performance-crux를 써요.
  • 업데이트 확인: 서버가 npm에서 새 버전을 주기적으로 확인해요. CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS로 끌 수 있어요.
  • 공식 지원 브라우저는 Google Chrome과 Chrome for Testing뿐이에요. 다른 Chromium 계열은 될 수도 있지만 보장되지 않아요.
  • 설정에 @latest를 쓰면 항상 최신 버전이 실행돼요. 편하지만, 버전을 고정하고 싶은 팀에서는 번호를 직접 적는 편이 좋아요.

저장소 상태

  • 별 56,570개, 포크 4,789개 (2026-11-15 기준)
  • 열린 이슈·PR 131건
  • 언어: TypeScript
  • 라이선스: Apache-2.0
  • 만든 날: 2025-09-11
  • 마지막 커밋: 2026-11-13. 최근 커밋은 CSS 변수 값을 풀어서 보여 주는 기능 추가, 도구 실행 중 페이지가 낸 오류를 목록으로 보여 주는 기능, 임시 파일 위치 수정 등이에요. 커밋 메시지에는 devtools-frontend 병합 준비 작업도 보여요.
  • 최신 릴리스: chrome-devtools-mcp-v1.13.0 (2026-11-11)
  • 최상위 폴더: src, skills, docs, tests, third_party, scripts. 그리고 Claude, Cursor, Gemini, Kimi용 플러그인 설정 폴더와 AGENTS.md가 있어요. README가 말하는 스킬과 문서 구성에 대응하는 폴더가 실제로 있어요.

확인 범위

2026-11-15에 GitHub의 저장소 정보, README 전체, 최근 커밋 5개, 최신 릴리스, 최상위 폴더 구조를 읽었어요. README가 링크한 도구 목록, 설정, 문제 해결 문서는 읽지 않았고, 코드 분석과 설치·실행도 하지 않았어요.

출처

ChromeDevTools/chrome-devtools-mcp (README, 릴리스, 커밋 기록)

Similar Posts