Unagi-cq/cdp-bridge-mcp

해결하는 문제

CDP Bridge MCP는 대규모 언어 모델(LLM) 및 AI 에이전트가 사용자의 실제 활성 브라우저 세션과 상호 작용할 수 있게 합니다. 기존의 헤드리스 브라우저 자동화(예: Playwright)와 달리 별도의 브라우저 인스턴스를 관리하거나 쿠키와 로그인 상태를 수동으로 전송할 필요가 없으며, 사용자가 이미 열고 인증한 페이지에 직접 연결됩니다.

작동 방식

시스템은 세 부분으로 구성됩니다: MCP 서버(Python으로 작성), Chromium 브라우저 확장 프로그램, MCP 호환 클라이언트(예: Claude Desktop).

1. 연결: MCP 클라이언트는 stdio 또는 streamable-http를 통해 서버에 연결됩니다. 동시에 브라우저 확장 프로그램은 WebSocket을 통해 서버에 연결됩니다.
2. 라우팅: 서버는 토큰을 사용하여 특정 MCP 클라이언트를 특정 브라우저 프로필/세션에 매핑하여 동일한 머신에서 다중 사용자 또는 다중 계정 격리를 허용합니다.
3. 실행: LLM이 도구를 호출하면 서버는 명령을 확장 프로그램에 보내고, 확장 프로그램은 chrome.scripting 또는 Chrome DevTools 프로토콜(CDP)을 사용하여 브라우저 페이지에서 JavaScript를 실행하고 결과를 반환합니다.

대상 사용자

• AI 에이전트 개발자: 사용자의 브라우저에서 사용자를 대신하여 작업을 수행해야 하는 제품을 구축하는 사람들.
• 고급 사용자: 이미 로그인한 웹사이트에서 LLM이 분석, 스크래핑 또는 작업 자동화를 수행하기를 원하는 개인.
• 운영/지원 팀: 데이터 수집이나 고객 서비스를 위해 여러 브라우저 계정이나 원격 브라우저 세션을 조정해야 하는 팀.

주요 특징

• 세션 재사용: 기존 브라우저 로그인 상태, 쿠키 및 페이지 상태를 활용합니다.
• 더 가벼운 토큰 사용: HTML을 단순화하여 토큰 낭비를 줄이면서 구조 정보를 보존하는 browser_scan 도구가 포함되어 있습니다.
• 다중 테넌트 지원: 토큰 기반 격리를 통해 서로 다른 컴퓨터의 여러 브라우저 프로필과 여러 사용자를 지원합니다.
• 유연한 배포: stdio를 통해 로컬에서 실행하거나 streamable-http를 사용하여 원격 서비스로 배포할 수 있습니다.
• 포괄적인 도구 세트: 탭 관리, 페이지 관찰, 요소 상호 작용(클릭/입력), JavaScript 실행, 스크린샷 및 탐색을 위한 12가지 도구를 제공합니다.