MCP 브라우저 에이전트

대장간 배지

AGI House MCP 해커톤에서 제작

개요

이 프로젝트는 모델 컨텍스트 프로토콜(MCP)을 사용하여 브라우저 상호작용을 지원하는 브라우저 자동화 에이전트입니다. MCP 서버를 통해 Claude와 브라우저 자동화 기능을 원활하게 통합합니다.

MCP 서버를 구동하는 데 도움이 되는 브라우저 에이전트 기능을 제공해 준 Browser-Use에 감사드립니다!

Related MCP server: 302AI BrowserUse MCP Server

시스템 요구 사항

macOS(다윈 24.2.0)
Python 3.12 이상
uv 패키지 관리자
Google Chrome 브라우저(작업을 실행하기 전에 브라우저를 닫아두세요.)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 브라우저 자동화 에이전트를 자동으로 설치하려면:

지엑스피1

수동 설치

저장소를 복제합니다.

git clone <repository-url> cd mcp

uv 사용하여 Python 환경을 설정합니다.

uv venv source .venv/bin/activate uv sync

구성

클로드 데스크톱 구성

Claude Desktop 구성 파일을 만들거나 수정하세요.

{ "mcpServers": { "browser-use": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/mcp", "run", "browser-use.py" ] } } }

/ABSOLUTE/PATH/TO/browser-use 프로젝트 디렉토리의 절대 경로로 바꾸세요.

브라우저 구성

에이전트는 다음 기본 설정으로 Google Chrome을 사용하도록 구성되어 있습니다.

개발을 위한 비헤드리스 모드
창 크기: 1280x1100
테스트를 위한 보안 기능 비활성화
녹음 경로: ./tmp/recordings

특징

MCP 도구를 통한 브라우저 자동화
국가 관리 및 계획 역량
대화형 요소 감지 및 조작
구성 가능한 브라우저 컨텍스트
로깅 및 디버깅 지원

용법

에이전트는 두 가지 주요 도구를 제공합니다.

get_planner_state : 현재 브라우저 상태 및 계획 컨텍스트를 검색합니다.
execute_actions : 브라우저에서 계획된 작업을 실행합니다.

개발

벌채 반출

이 프로젝트는 다음 구성을 사용하여 Python의 내장 로깅을 사용합니다.

모든 로그는 stderr로 전송됩니다.
사용자 지정 서식: %(levelname)-8s [%(name)s] %(message)s
루트 로거 레벨: INFO
타사 로거 수준: 경고

프로젝트 구조

browser-use.py : 주요 진입점 및 서버 구현
tmp/recordings : 브라우저 세션 녹음을 위한 디렉토리
uv 통해 관리되는 종속성

기여하다

이 프로젝트는 AGI House MCP 해커톤 기간 동안 진행되었습니다. 여러분의 참여를 환영합니다!

특허

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

본 소프트웨어 및 관련 문서 파일(이하 "소프트웨어")의 사본을 취득한 모든 사람에게 소프트웨어를 제한 없이 거래할 수 있는 권한을 무상으로 부여합니다. 여기에는 소프트웨어 사본을 사용, 복사, 수정, 병합, 게시, 배포, 하위 라이선스 및/또는 판매할 수 있는 권한이 포함되나 이에 국한되지 않으며, 소프트웨어가 제공된 사람에게도 이러한 권한을 부여합니다. 단, 다음 조건에 따라야 합니다.

본 소프트웨어는 상품성, 특정 목적 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않는 명시적 또는 묵시적 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 저작자 또는 저작권자는 본 소프트웨어 또는 본 소프트웨어의 사용 또는 기타 거래와 관련하여 발생하는 계약, 불법 행위 또는 기타 소송을 포함한 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다.