jumodada/Drissionpage-MCP-Server

해결하는 문제

DrissionPage MCP 서버는 AI 모델(Claude 또는 Codex 등)이 웹 브라우저를 고정밀로 제어할 수 있도록 합니다. 모델의 추론과 실제 브라우저 실행 사이의 격차를 메우며, AI가 웹사이트를 탐색하고 데이터를 추출하며, 폼을 채우고, 전통적인 스크래퍼나 단순 자동화 도구가 어려워하는 복잡한 시각적 요소와 상호작용할 수 있게 합니다.

작동 방식

로컬 Model Context Protocol (MCP) 서버로서 DrissionPage 라이브러리 기반의 69개의 타입 지정 도구를 노출합니다. 이러한 도구를 통해 모델은 다음을 수행할 수 있습니다:

• DOM 또는 좌표를 통한 상호작용: 구조화된 데이터에는 표준 CSS/XPath 선택자를 사용하거나, 시각적 표면(캔버스 또는 지도 등)에는 정확한 X/Y 좌표를 사용합니다.
• 자연스러운 움직임: 결정론적인 24단계의 부드러운 3차 곡선 경로를 사용해 로봇처럼 즉각적인 점프를 피하고 인간과 유사한 마우스 이동을 시뮬레이션합니다.
• 상태 관리: 여러 탭을 처리하고 쿠키/저장소를 관리하며 네트워크 트래픽을 관찰합니다.
• 검증: 다음 단계로 진행하기 전에 작업 결과를 확인하기 위해 스크린샷과 접근성 스냅샷을 캡처합니다.

대상 사용자

• AI 에이전트 개발자: 실제 웹 작업을 수행해야 하는 에이전트를 개발하는 사람.
• QA 엔지니어: AI 기반의 자동화된 브라우저 테스트 워크플로우를 만드는 사람.
• 연구자: 웹 자동화 및 접근성과 관련된 기술적 연구를 수행하는 사람.
• 파워 유저: Claude Desktop 또는 Codex와 같은 MCP 호환 클라이언트를 사용하여 AI가 완전히 기능하는 브라우저를 갖기를 원하는 사람.

주요 특징

• 69개의 원자적 도구: 탐색, 탭 관리, 요소 상호작용, 네트워크 관찰에 대한 포괄적인 커버리지.
• 결정론적 자연스러운 움직임: 재현 가능한 인간과 유사한 마우스 이동으로 더 자연스러운 상호작용을 가능하게 합니다.
• 비전 대응: 스크린샷에서 좌표를 식별할 수 있는 멀티모달 모델과 함께 작동하도록 설계되었습니다.
• 심층 브라우저 접근: Shadow DOM, iframe, 직접 Chromium/CDP 제어를 지원합니다.
• 타입 안전: Pydantic 검증을 사용해 AI가 올바르게 포맷된 명령을 전송하도록 보장합니다.