WeaveTab MCP V2

AI 에이전트를 위한 제로 설정 로컬 브라우저 MCP

npm version License: MIT Socket Badge

WeaveTab은 AI 에이전트가 Chrome DevTools Protocol(CDP)을 사용하여 웹 브라우저와 원활하게 상호 작용할 수 있도록 지원하는 가볍고 로컬에서 실행되는 Model Context Protocol(MCP) 서버입니다. 다른 솔루션과 달리 WeaveTab은 완전히 자율적이며 제로 설정을 지향합니다. 일상적인 브라우징과 병렬로 샌드박스 처리된 브라우저 프로필을 자동으로 실행하므로, 브라우저를 닫거나 디버깅 포트를 설정하느라 번거로울 필요가 전혀 없습니다.

🌟 주요 기능

제로 설정 자율 브라우저: 격리된 샌드박스를 통해 기존 브라우저와 완전히 병렬로 실행됩니다. 수동 포트 구성이 필요 없으며 개인 브라우저를 닫을 필요도 없습니다.
확장 프로그램 불필요: 기본 CDP를 통해 직접 연결합니다.
시맨틱 액션 맵: weave_read는 파싱되고 고도로 압축된 DOM 시맨틱 맵을 반환하여 토큰 소비를 크게 줄입니다.
스나이퍼 모드 액션: weave_click 및 weave_type은 의도나 레이블을 기반으로 한 단계에서 요소를 자동으로 찾아 상호 작용합니다.
로컬 및 보안: 클라우드 의존성이 없습니다. 내장된 속도 제한 및 선택적 안전 모드를 제공합니다.
스크린샷 지원: 선택적으로 weave_screenshot을 사용하여 현재 탭을 캡처하거나, weave_peek을 사용하여 특정 요소/캔버스에 대한 타겟팅된 비전을 활용할 수 있습니다.

🚀 빠른 시작 (MCP 통합)

WeaveTab을 사용하는 가장 쉬운 방법은 npx를 이용하는 것입니다. MCP 클라이언트 구성(예: Cursor, OpenCode, Claude Desktop)에 다음을 추가하세요.

Cursor / OpenCode

IDE의 MCP 구성 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

Claude Desktop

claude_desktop_config.json 파일을 편집하세요:

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

🛠️ 도구 모음

WeaveTab은 AI를 위한 다양한 전문 도구를 제공합니다:

weave_read: 페이지를 읽고 시맨틱 액션 맵을 반환합니다.
weave_click: 레이블, 의도 또는 ID로 요소를 클릭합니다.
weave_type: 폼에 텍스트를 안전하게 입력합니다.
weave_navigate: 대상 URL로 이동합니다.
weave_scroll: 위, 아래, 맨 위 또는 맨 아래로 스크롤합니다.
weave_wait: 특정 상태(탐색, 요소, DOM 안정성)를 기다립니다.
weave_tabs: 열려 있는 탭을 나열하거나 탭 간을 전환합니다.
weave_extract: 표시된 콘텐츠를 텍스트나 JSON으로 추출합니다.
weave_screenshot: 현재 화면의 PNG를 캡처합니다.
weave_peek: 특정 좌표에 대한 타겟팅된 비전 기능을 수행합니다.
weave_key: 물리적 키와 수정 키를 누릅니다.
weave_find: 전체 페이지를 추출하지 않고도 시맨틱하게 요소를 찾습니다.

🛡️ 보안 및 구성

WeaveTab은 시스템을 존중합니다. root/sudo 권한으로 실행되는 것을 적극적으로 거부합니다.

처음 실행 시 WeaveTab은 ~/.weavetab/config.json에 구성 파일을 생성합니다:

{
  "safeMode": false,
  "allow": [],
  "rateLimitMs": 1000,
  "preferredBrowser": "google-chrome",
  "persistentProfile": false,
  "screenshot": true,
  "peek": true
}

안전 기능

스토리지 하드 블록: 특정 환경에서 쿠키/localStorage에 액세스하는 스크립트를 비활성화합니다.
루트 감지: 루트 권한으로 실행되면 종료됩니다.
도메인 허용 목록: safeMode가 활성화되어 있을 때 에이전트가 신뢰할 수 없는 사이트로 이동하는 것을 방지합니다.
감사 로깅: AI가 수행한 모든 작업은 검토를 위해 ~/.weavetab/audit.log에 로컬로 깔끔하게 기록됩니다.

🤝 기여하기

기여를 환영합니다!

git clone https://github.com/fy2ne/WeaveTab.git
cd WeaveTab
npm install
npm run build

📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

WeaveTab-MCP