Better AI Browser Utilities (BABU)

토큰 효율적인 MCP 제어로 이미 사용 중인 Chrome 세션을 다룹니다—탭, 쿠키, 로그인, 그 외 모든 것. BABU는 별도의 자동화 프로필을 실행하는 대신, MCP 호환 코딩 에이전트를 로컬 Chrome 확장 프로그램에 연결합니다.

BABU를 사용하는 이유

• 기본 제공되는 4개의 간결한 MCP 스키마—반복적인 브라우저 도구 20개 대신.

• 점진적 공개(Progressive disclosure): browser_read는 제한된 텍스트와 간결한 컨트롤을 반환하고, browser_help는 요청 시에만 명령 세부 정보를 공개합니다.

• 빠른 작업: browser_do는 탐색, 클릭, 타이핑, 키 입력, 스크롤, 대기, 스크린샷, JavaScript, 루프백 파일 업로드를 처리합니다.

• 실제 브라우저 상태: 기존 Chrome 탭과 인증된 세션을 사용합니다.

• 이식성: uvx로 GitHub에서 직접 설치; 문서화된 모든 클라이언트는 표준 MCP stdio를 사용합니다.

• 로컬 우선: 유일한 네트워크 리스너는 127.0.0.1에 바인딩됩니다. 확장 프로그램 WebSocket은 생성된 페어링 토큰을 요구합니다.

게시된 MCP v2 스키마는 컴팩트 모드에서 567토큰을 측정하며, 레거시 20개 도구 표면의 2,219토큰과 비교됩니다: 모델 턴당 스키마 컨텍스트 74.45% 절감 (o200k_base, 표준 JSON, 클라이언트 프레이밍 제외).

아키텍처

MCP client
   |  stdio (client-owned subprocess)
   v
BABU Python bridge
   |  authenticated WebSocket ws://127.0.0.1:8765
   v
BABU Chrome extension (MV3) -> your real Chrome tabs

설치

사전 요구 사항: uv 및 Chrome 116 이상.

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup

이 명령은 번들된 확장 프로그램을 ~/.babu/extension으로 내보내고, ~/.babu/token을 생성하며, 페어링을 위해 토큰을 한 번 출력합니다.

Chrome에서:

1. chrome://extensions를 엽니다.

2. 개발자 모드를 활성화합니다.

3. 압축 해제된 확장 프로그램 로드를 선택하고 출력된 확장 프로그램 디렉터리를 선택합니다.

4. BABU 확장 프로그램을 열고 페어링 토큰을 붙여넣은 후 저장을 선택합니다.

안정 버전 Chrome은 더 이상 자동화된 --load-extension 설치를 허용하지 않으므로, 일회성 수동 로드가 필요합니다.

MCP 클라이언트에 BABU 추가

이 stdio 실행 정의를 사용하세요:

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0",
    "babu",
    "mcp"
  ]
}

Hermes, Codex, Claude Code, Cursor, VS Code, Zed, ZCode, Gemini CLI, OpenCode, Cline, Windsurf, Pi, Agent Prime에 대한 정확한 명령과 구성 파일은 docs/CLIENTS.md에 있습니다.

한 번에 하나의 BABU 프로세스만 WebSocket 포트 8765를 소유할 수 있습니다. 새 하네스를 시작하기 전에 다른 BABU 지원 하네스를 닫으세요.

MCP 도구

browser_do 명령:

list_tabs, get_active_tab, open_tab, close_tab, activate_tab, navigate,
get_state, snapshot, click, hover, type, select, press, scroll, extract_text, screenshot,
eval, upload_files, wait_for, back, forward, reload

권장 흐름:

1. 관련 query로 browser_read를 호출합니다.

2. 반환된 요소 인덱스를 click 또는 type과 함께 browser_do에 전달합니다.

3. 탐색 또는 주요 DOM 변경 후에는 인덱스가 문서 로컬이므로 다시 읽습니다.

4. 명령의 매개변수가 불분명할 때만 browser_help를 사용합니다.

스크린샷은 기본적으로 시스템 임시 디렉터리에 저장됩니다. include_data_url=true가 명시되지 않는 한 base64 이미지 바이트는 모델 컨텍스트에서 제외됩니다.

CLI 유틸리티

babu setup [--force]            # export/update extension and create token
babu token                      # print the current pairing token
babu mcp                        # stdio MCP server, compact profile
babu relay list_tabs            # direct browser command without an MCP client
babu relay navigate '{"url":"https://example.com"}'

babu relay는 MCP보다 CLI 도구를 선호하는 최소 하네스에 유용합니다.

도구 프로필

• compact(기본값): 위의 네 가지 도구.

• legacy: 작업당 하나의 스키마를 선호하는 클라이언트를 위한 20개의 직접 브라우저 도구.

• all: 두 표면 모두.

--tool-profile compact|legacy|all 또는 BABU_TOOL_PROFILE로 프로필을 선택하세요.

보안

BABU는 로그인된 브라우저 프로필을 제어하므로 강력한 로컬 도구로 취급하세요.

• WebSocket 리스너는 127.0.0.1에만 바인딩됩니다. MCP는 stdio를 통해 전송됩니다.

• Chrome 확장 프로그램 출처와 클라이언트 역할이 검증됩니다.

• 확장 프로그램-브리지 채널은 ~/.babu/token에 저장된 256비트 토큰을 사용합니다.

• 확장 프로그램 팝업은 즉시 모든 제어를 비활성화할 수 있습니다.

• 비밀번호, OTP, 결제 필드는 일상적인 읽기에서 편집됩니다.

• browser_eval은 설계상 페이지의 메인 월드에서 JavaScript를 실행합니다.

• 파일 업로드는 자격 증명이 없는 제한된 직접 루프백 HTTP(S) URL만 허용합니다.

모든 MCP 도구 호출을 검토하고 각 클라이언트의 승인 컨트롤을 사용하세요.

제한 사항

• Chrome 내부 페이지, 웹 스토어, PDF 뷰어, 언로드된 탭, iframe 또는 shadow root 내부의 컨트롤은 구동할 수 없습니다.

• 엄격한 페이지 CSP는 browser_eval을 차단할 수 있습니다. DOM 읽기/클릭/타이핑 도구는 여전히 작동합니다.

• browser_press는 Enter, Tab, 합성 Escape를 지원합니다. 텍스트에는 browser_type을 사용하세요.

• 업데이트 후 압축 해제된 확장 프로그램은 chrome://extensions에서 다시 로드해야 합니다.

• 서버는 설계상 단일 클라이언트 및 단일 브라우저 확장 프로그램입니다.

업데이트

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup --force

chrome://extensions에서 BABU를 다시 로드한 다음 MCP 클라이언트를 다시 시작하세요. 새 릴리스를 채택할 때 클라이언트 구성의 Git 태그를 변경하세요.

라이선스

MIT