프로젝트 소개

에이전트용 Chrome DevTools(chrome-devtools-mcp)는 Antigravity, Claude, Cursor, Copilot 등 AI 코딩 어시스턴트가 실행 중인 Chrome 브라우저를 제어하고 검사할 수 있는 기능을 제공하는 MCP 서버입니다. Model Context Protocol을 통해 Chrome DevTools의 기능을 노출하여 안정적인 자동화, 디버깅, 성능 분석을 지원합니다. MCP 없이 사용할 수 있는 CLI도 함께 제공됩니다. 주요 기능: - 성능 인사이트: Chrome DevTools 트레이스를 기록하고 실행 가능한 성능 정보를 추출합니다. - 고급 브라우저 디버깅: 네트워크 요청을 검사하고 스크린샷을 촬영하며, 소스 맵이 적용된 스택 트레이스를 포함한 브라우저 콘솔 메시지를 읽습니다. - 안정적인 자동화: Puppeteer를 사용해 Chrome에서 작업을 자동화하고 작업 결과가 나올 때까지 자동으로 대기합니다. 공식 지원 대상은 Google Chrome과 Chrome for Testing 뿐입니다. 다른 Chromium 기반 브라우저에서도 작동할 수는 있지만 보장되지는 않습니다. 성능 도구는 실제 사용자 경험 데이터를 가져오기 위해 트레이스 URL을 Google CrUX API로 전송할 수 있으며, 이 기능은 --no-performance-crux 플래그로 비활성화할 수 있습니다. 기본적으로 안정성과 성능 향상을 위해 사용 통계가 수집되며, --no-usage-statistics 플래그나 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS, CI 환경 변수를 통해 수집을 거부할 수 있습니다. 또한 CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS 환경 변수가 설정되지 않은 경우 서버는 npm 레지스트리를 확인해 업데이트를 조회합니다. 설정은 MCP 클라이언트 설정에 패키지를 추가하는 방식으로 진행하며, 예시는 다음과 같습니다: { "mcpServers": { "chrome-devtools": { "command": "npx", "args": ["-y", "chrome-devtools-mcp@latest"] } } } 기본 브라우저 작업용 슬림 모드도 제공되며, 문서에는 동시 세션, 영구 사용자 데이터 디렉터리, 실행 중인 Chrome 인스턴스 연결, Android 디버깅 등 고급 사용법이 안내되어 있습니다. 이 패키지는 에이전트 툴링에서 통합 브라우저 하위 에이전트를 구축하기 위한 기반으로도 활용할 수 있습니다.