Chrome Control MCP

AI 어시스턴트를 위한 가시적이고 정밀한 Chrome 제어. 설계상 로컬 전용.

빠른 시작 · 도구 카탈로그 · 아키텍처 · 보안 · 검증

활성 자동화는 항상 표시됩니다. 분홍색 프레임, AI CONTROL 배지, 그리고 맥동하는 에이전트 커서가 어시스턴트가 Chrome을 제어할 때 나타납니다. 모델용 스크린샷은 기본적으로 이 오버레이를 숨기며, 문서 캡처는 옵트인할 수 있습니다.

이 프로젝트를 만든 이유

모든 43개 MCP 도구는 엄격한 JSON Schema를 사용합니다. 장기 실행 MCP 프로세스는 세션 및 요소 참조 상태를 유지하는 반면, Chrome은 일반적인 사용자 제어 브라우저로 유지됩니다.

Related MCP server: Chrome MCP Server

작동 모습

두 이미지 모두 라이브 확장 프로그램의 직접적인 browser_screenshot 결과이며, 목업이 아닙니다.

테스팅 감사 인사: Inflectra의 UI Test Automation Playground 및 오픈소스 저장소는 집중적이고 실용적인 브라우저 상호작용 시나리오를 제공합니다. 이 프로젝트의 전체 MCP-to-Chrome 경로를 테스트하는 데 매우 귀중했습니다.

빠른 시작

1. 빌드 요구 사항 설치

• Windows 10/11 x64, Linux x64 또는 macOS

• Google Chrome 116+

• CMake 3.25+

• Core 및 Test 구성 요소가 포함된 Qt 6.5+

• C++20 컴파일러: Visual Studio 2022, GCC 또는 Clang

• Node.js 20.19+

2. 빌드 및 테스트

npm ci
npm run build

기본 출력:

PowerShell 사용자는 대신 ./scripts/build.ps1 -Configuration Release를 실행할 수 있습니다. 두 경로 모두 경고를 오류로 처리하여 빌드하고 모든 네이티브 및 확장 프로그램 단위 테스트 스위트를 실행합니다.

3. Chrome 준비

npm run extension -- install

chrome://extensions를 열고 개발자 모드를 활성화한 다음 압축 해제된 확장 프로그램 로드를 선택하고 명령이 출력한 폴더를 선택합니다. Chrome은 압축 해제된 확장 프로그램에 대해 이 수동 단계를 한 번 요구합니다.

서명 키, 패키징된 확장 프로그램, 스토어 계정, 관리자 액세스 또는 엔터프라이즈 정책이 필요하지 않습니다. manifest.json의 공개 key는 압축 해제된 확장 프로그램 ID만 고정하며, 소프트웨어를 서명할 수 없습니다.

4. 어시스턴트 연결

절대 실행 파일 경로를 사용하세요.

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Code는 동일한 실행 파일을 사용합니다:

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

전송 방식은 stdio를 통한 개행 구분 JSON-RPC입니다. 서버는 TCP 리스너를 열지 않습니다.

아키텍처

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

하나의 실행 파일이 MCP 서버와 네이티브 호스트 릴레이 역할을 모두 제공합니다. 브라우저 제어는 MCP에 속합니다. 호출 가능한 도구, 이미지 결과, 강화된 IPC 및 영구 세션 상태가 필요하기 때문입니다. 스킬은 워크플로를 추가할 수 있지만 서버를 대체하지는 않습니다.

보안 모델

전체 제어는 강력합니다. Chrome Control MCP는 확장 프로그램 출처를 고정하고, IPC를 제한 및 검증하며, 동일 사용자/동일 실행 파일 릴레이를 인증하고, 오래된 요소 참조 및 스크린샷 좌표를 거부하며, 주요 페이로드를 제한하고, 엄격한 스키마를 노출합니다.

Windows는 현재 사용자 ACL로 보호된 명명된 파이프를 사용합니다. Linux와 macOS는 개인 런타임 디렉터리 내의 모드-0600 Unix 소켓과 운영 체제 피어 자격 증명을 사용합니다.

검사 전용 사용의 경우:

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

읽기 전용 프로필은 10개의 도구를 노출하고 숨겨진 변경 호출을 독립적으로 거부합니다.

검증

현재 로컬 Windows 및 Linux 게이트는 다음을 포함합니다:

• MSVC, GCC 및 Clang을 사용한 9/9 네이티브 및 확장 프로그램 스위트

• 경고를 오류로 처리하는 빌드와 clang-tidy 및 철저한 cppcheck

• 별도의 ASan+UBSan 및 TSan 실행

• 전체 기록 Gitleaks 스캔 및 npm 의존성 감사

• Windows의 실제 Chrome을 통한 43/43 라이브 MCP 도구

• 공개 UI Playground 탐색, 스냅샷, 타이핑, 클릭 및 PNG 캡처

• 되돌릴 수 있는 네이티브 호스트 설치/상태 확인/제거 수명 주기

GitHub Actions는 모든 직접 푸시 시 Windows, Linux 및 macOS에서 빌드 및 테스트합니다.

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

PowerShell 라이브 공개 사이트 확인:

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

정확한 증거 및 주장 범위 보기.

프로젝트 식별 정보

사용 중단 시 npm run extension -- uninstall로 현재 사용자 네이티브 호스트를 등록 해제한 다음 chrome://extensions에서 압축 해제된 확장 프로그램을 수동으로 제거하세요.

라이선스

MIT License에 따라 배포됩니다. Copyright © 2026 Randy Northrup.