MCP-감지되지 않음-크롬 드라이버

탐지되지 않은 크롬 드라이버 기반으로 구축된 MCP 서비스로, 봇 탐지를 우회하면서 크롬 브라우저 제어를 자동화하기 위한 포괄적인 인터페이스를 제공합니다.

설치

Smithery를 통해 Claude Desktop용 MCP-Undetected-Chromedriver를 자동으로 설치하려면:

지엑스피1

감지되지 않은 Chromedriver 서버를 사용하기 위한 구성

Undetected-chromedriver 서버를 사용하기 위한 Claude Desktop 구성은 다음과 같습니다.

{
  "mcpServers": {
    "mcp-undetected-chromedriver": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@dragons96/mcp-undetected-chromedriver",
        "--config",
        "{}"
      ]
    }
  }
}

요구 사항

파이썬 >= 3.11
크롬 브라우저

uv로 설치

# Create virtual environment
uv venv

# Activate virtual environment
# Windows
.venv\Scripts\activate
# Linux/MacOS
source .venv/bin/activate

# Install dependencies
uv pip install -e .

프로젝트 소개

MCP-Undetected-Chromedriver는 undetected-chromedriver 라이브러리의 기능을 사용하기 쉬운 API로 래핑한 MCP(다중 채널 프로토콜) 서비스입니다. 이 프로젝트는 특히 자동화 테스트, 데이터 스크래핑 또는 웹 자동화 스크립트에서 최신 웹사이트 봇 탐지 메커니즘을 우회해야 하는 상황에 적합합니다.

주요 특징

감지되지 않은 크롬 드라이버를 기반으로 웹사이트 봇 감지를 효과적으로 우회합니다.
풍부한 브라우저 운영 API 인터페이스를 제공합니다
스크린샷, PDF 내보내기 및 기타 기능을 지원합니다.
클릭, 양식 작성, 드래그 등 복잡한 페이지 상호작용 작업을 지원합니다.
MCP 생태계의 다른 도구와 완벽하게 통합됩니다.

할 일 목록

[ ] 브라우저 드라이버 관리를 최적화하고 드라이버 중단을 처리합니다.
[ ] API 기능 확장
[ ] 보다 포괄적인 오류 처리 및 로깅 추가
[ ] 더 많은 사용 예를 통해 문서를 개선합니다.
[ ] 브라우저 프로필 및 확장 기능에 대한 지원 추가

용법

서비스 시작

mcp-server-undetected-chromedriver

사용 가능한 API

이 서비스는 다음과 같은 주요 API 인터페이스를 제공합니다.

browser_navigate : 지정된 URL로 이동합니다
browser_screenshot : 현재 페이지의 스크린샷을 찍습니다.
browser_click : 페이지 요소를 클릭합니다.
browser_iframe_click : iframe 내의 요소를 클릭합니다.
browser_fill : 입력 필드에 내용 채우기
browser_select : 드롭다운 선택 상자에서 옵션을 선택합니다.
browser_hover : 마우스를 요소 위로 올려놓습니다.
browser_evalute : JavaScript 코드 실행
browser_close : 브라우저를 닫습니다
browser_get_visible_text : 페이지에 표시되는 텍스트를 가져옵니다.
browser_get_visible_html : 페이지에 표시되는 HTML 가져오기
browser_go_back : 브라우저 기록에서 뒤로 이동합니다.
browser_go_forward : 브라우저 기록에서 앞으로 이동합니다.
browser_drag : 드래그 요소
browser_press_key : 키 입력을 시뮬레이션합니다.
browser_save_as_pdf : 페이지를 PDF로 저장합니다.

코드 예제

from mcp.client import Client

# Create MCP client
client = Client()
client.start("undetected-chromedriver-mcp-server")

# Navigate to website
response = client.call("browser_navigate", {"url": "https://example.com"})
print(response)

# Take a screenshot
response = client.call("browser_screenshot", {"name": "example"})
print(response)

# Get page text
response = client.call("browser_get_visible_text")
print(response.content[0].text)

# Close the browser
client.call("browser_close")

작동 원리

이 서비스는 undetected-chromedriver 라이브러리를 사용하여 일반적인 봇 탐지 메커니즘을 효과적으로 회피하는 특수 Chrome 브라우저 인스턴스를 생성합니다. 이 서비스는 MCP 프로토콜을 통해 이러한 기능을 래핑하여 자동화된 테스트 및 웹 스크래핑을 더욱 편리하게 만드는 사용하기 쉬운 API 인터페이스를 제공합니다.

특허

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

기여 지침

GitHub 이슈 페이지에서 버그 리포트와 기능 요청을 환영합니다. 코드 기여를 원하시면 먼저 이슈를 생성하여 아이디어를 공유해 주세요.

자주 묻는 질문

질문: 표준 셀레늄 웹드라이버 대신 undetected-chromedriver를 선택하는 이유는 무엇입니까?

A: undetected-chromedriver는 Cloudflare, Distil Networks 등과 같은 최신 웹사이트의 봇 탐지 메커니즘을 우회하도록 특별히 설계되어 데이터 스크래핑 및 자동화 테스트 시나리오에서 더욱 안정적입니다.

질문: 서비스는 브라우저 인스턴스를 어떻게 처리하나요?

A: 이 서비스는 브라우저가 필요한 API가 처음 호출될 때 자동으로 생성되는 글로벌 브라우저 인스턴스를 유지합니다. 브라우저는 browser_close API를 사용하여 명시적으로 닫을 수 있습니다.

질문: iframe 내의 요소를 어떻게 처리하나요?

답변: browser_iframe_click API는 프레임 컨텍스트를 수동으로 전환할 필요 없이 iframe 내의 요소에서 직접 작동할 수 있습니다.

MCP-Undetected-Chromedriver

Integrations