Chrome Live MCP

이미 사용 중인 Chrome(로그인된 세션, 쿠키, 탭, 확장 프로그램 환경 포함)에 로컬 stdio MCP 에이전트를 연결하세요. 두 번째 브라우저를 실행할 필요가 없습니다.

Chrome Live MCP는 독립적인 구현입니다. chrome-devtools-mcp를 설치, 가져오기, 실행 또는 래핑하지 않습니다.

요구 사항

• Google Chrome 144 이상

• Node.js 20 이상

• stdio를 통한 로컬 MCP 서버를 지원하는 데스크톱 에이전트

Related MCP server: chrome-profile-debug

1회성 Chrome 설정

1. Chrome을 버전 144 이상으로 업데이트합니다.

2. Chrome에서 chrome://inspect/#remote-debugging을 엽니다.

3. 원격 디버깅을 활성화하고 Chrome을 실행 상태로 둡니다.

Chrome이 인증을 계속 제어합니다. Chrome에서 연결을 허용할지 묻는 경우 프롬프트를 검토하고 허용을 선택하세요.

자동화 대상을 선택하는 것은 백그라운드에서만 이루어집니다. 연결하거나 browser_select_tab을 호출해도 해당 탭이 활성화되거나 현재 Chrome 작업에서 포커스를 빼앗지 않습니다.

ZCode

설정 → MCP 서버 → 새 MCP 서버를 열고 다음을 입력합니다:

• 범위: User

• 유형: stdio

• 이름: chrome-live

• 명령: npx

• 인수: -y chrome-live-mcp@latest

항목을 활성화하고 새 ZCode 작업을 시작합니다. 정확한 스모크 테스트는 ZCODE_TESTING.md를 참조하세요.

Kimi Code CLI

kimi mcp add --transport stdio chrome-live -- npx -y chrome-live-mcp@latest
kimi mcp test chrome-live

다른 MCP 클라이언트의 경우 다음 표준 구성을 사용하세요:

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

로컬 개발

npm install
npm test
npm run typecheck
npm run bundle --workspace chrome-live-mcp
node packages/cli/dist/main.js doctor

MCP 클라이언트에서 로컬 체크아웃을 테스트하려면 npx 구성을 다음으로 교체하세요:

{
  "command": "node",
  "args": ["/absolute/path/to/chrome-live-mcp/packages/cli/dist/main.js", "serve"]
}

도구 및 안전

서버는 연결, 탭, 의미론적 스냅샷, 스크린샷, 포인터, 키보드, 양식 선택, 페이지 및 참조된 컨테이너 스크롤, 탐색, 대기 도구를 제공합니다. browser_scroll_to는 내부 목록이나 패널을 해당 상단 또는 하단으로 직접 이동할 수 있습니다. 임의의 JavaScript 평가, 원시 CDP, 쿠키, 저장소, 비밀번호 또는 인증 헤더는 의도적으로 노출하지 않습니다.

한 번에 하나의 Chrome Live MCP 프로세스만 Chrome을 제어합니다. 모든 프로토콜 트래픽은 stdin/stdout을 사용하며, 서버는 수신 대기 네트워크 포트를 열지 않습니다. 페이지 콘텐츠는 신뢰할 수 없으며, 결과에 영향을 미치는 작업은 호출 에이전트의 승인 정책에 따라야 합니다.

상태

초기 호환성 대상은 ZCode Desktop, ZCode CLI, Kimi Code CLI, Claude Code, Cursor 및 기타 표준을 준수하는 로컬 stdio MCP 클라이언트입니다. 호환성이란 클라이언트가 로컬 명령을 실행하고 표준 MCP initialize, tools/list, tools/call을 구현할 수 있음을 의미합니다. 클라우드 전용 클라이언트는 이 범위에 포함되지 않습니다.

라이선스

MIT