angiejones/mcp-selenium

Browser automation

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

430 stars 121 forks 품질 71 트렌드 20MIT

Repository Install

Selenium WebDriver용 MCP 구현

개요

Selenium WebDriver용 모델 컨텍스트 프로토콜(MCP) 서버 — AI 에이전트를 위한 브라우저 자동화. 크롬을 열고 github.com/angiejones 로 가서 스크린샷을 찍으세요. 에이전트는 start_browser, 내비게이션, take_screenshot을 위해 Selenium의 API를 호출합니다. 수동 스크립팅이나 명시적인 지시가 필요하지 않습니다. macOS가 필요합니다. sudo safaridriver를 실행하세요 -- 한 번 활성화하고 Safari → 개발자 설정에서 "원격 자동화 허용"→ 활성화하세요. 헤드리스 모드는 없습니다. 텍스트를 요소에 입력합니다. 필드를 먼저 비웁니다. 요소로부터 속성 값을 얻습니다. 파일 입력 요소를 통해 파일을 업로드합니다. 현재 페이지의 스크린샷을 캡처합니다.

개요(AI 번역)

Selenium WebDriver용 모델 컨텍스트 프로토콜(MCP) 서버 — AI 에이전트를 위한 브라우저 자동화.

준비

Goose (데스크톱)

브라우저 주소창에 붙여넣으세요:

거위 (CLI)

클로드 코드

커서 / 윈드서프 / 기타 MCP 클라이언트

예시 사용

원하는 AI 에이전트에게 말하세요:

크롬을 열고 github.com/angiejones 로 가서 스크린샷을 찍으세요.

에이전트는 셀레늄의 API를 start_browser, navigate, take_screenshot로 호출합니다. 수동 스크립팅이나 명시적 지시가 필요하지 않습니다.

지원되는 브라우저

크롬, 파이어폭스, 엣지, 그리고 사파리.

Safari 참고: macOS가 필요합니다. sudo safaridriver --enable를 한 번 실행하고 활성화하세요 Safari → 개발자 설정에서 “원격 자동화 허용”→ 하세요. 헤드리스 모드는 없습니다.

도구

start_browser

브라우저 세션을 실행합니다.

매개변수	유형	필수	설명
브라우저	문자열	예	`chrome`, `firefox`, `edge`, 또는 `safari`
옵션	객체	아니요	`{ headless: boolean, arguments: string[] }`

README

원문 README의 일부입니다. 원문 보기.

MCP Selenium Server

A Model Context Protocol (MCP) server for Selenium WebDriver — browser automation for AI agents.

Setup

Example Usage

Tell the AI agent of your choice:

Open Chrome, go to github.com/angiejones, and take a screenshot.

The agent will call Selenium’s APIs to start_browser, navigate, and take_screenshot. No manual scripting or explicit directions needed.

Supported Browsers

Chrome, Firefox, Edge, and Safari.

Safari note: Requires macOS. Run sudo safaridriver --enable once and enable “Allow Remote Automation” in Safari → Settings → Developer. No headless mode.

start_browser

Launches a browser session.

Parameter	Type	Required	Description
browser	string	Yes	`chrome`, `firefox`, `edge`, or `safari`
options	object	No	`{ headless: boolean, arguments: string[] }`

navigate

Navigates to a URL.

Parameter	Type	Required	Description
url	string	Yes	URL to navigate to

interact

Performs a mouse action on an element.

Parameter	Type	Required	Description
action	string	Yes	`click`, `doubleclick`, `rightclick`, or `hover`
by	string	Yes	Locator strategy: `id`, `css`, `xpath`, `name`, `tag`, `class`
value	string	Yes	Value for the locator strategy
timeout	number	No	Max wait in ms (default: 10000)

send_keys

Types text into an element. Clears the field first.

Parameter	Type	Required	Description
by	string	Yes	Locator strategy
value	string	Yes	Locator value
text	string	Yes	Text to enter

GitHub에서 전체 README 보기

설치

npx -y @angiejones/mcp-selenium@latest

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "selenium": {
      "command": "npx",
      "args": ["-y", "@angiejones/mcp-selenium@latest"]
    }
  }
}