크롬 MCP 서버

Chrome DevTools 프로토콜(CDP)을 통해 Chrome 브라우저 인스턴스에 대한 세부적인 제어를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

필수 조건

Bun (권장) 또는 Node.js(v14 이상)
원격 디버깅이 활성화된 Chrome 브라우저

설정

Bun 설치

Bun을 설치하세요(아직 설치되지 않은 경우):

지엑스피1

원격 디버깅을 활성화하여 Chrome을 시작합니다.포함된 스크립트를 사용하면 OS를 자동으로 감지하고 올바른 명령으로 Chrome을 시작할 수 있습니다.
# Make the script executable chmod +x start-chrome.sh # Run the script ./start-chrome.sh
또는 원격 디버깅을 사용하여 Chrome을 수동으로 시작합니다.
# macOS /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 # Windows start chrome --remote-debugging-port=9222 # Linux google-chrome --remote-debugging-port=9222
종속성 설치:

bun install

서버를 시작합니다:

bun start

핫 리로딩을 통한 개발의 경우:

bun dev

서버는 기본적으로 3000번 포트에서 시작됩니다. PORT 환경 변수를 설정하여 이 포트를 변경할 수 있습니다.

이 MCP 서버를 사용하도록 Roo 코드 구성

Roo Code와 함께 이 Chrome MCP 서버를 사용하려면:

Roo 코드 설정 열기
다음 위치의 MCP 설정 구성 파일로 이동합니다.
- macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
- Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
- 리눅스: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
mcpServers 개체에 다음 구성을 추가합니다.

{
  "mcpServers": {
    "chrome-control": {
      "url": "http://localhost:3000/sse-cursor",
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

파일을 저장하고 Roo Code를 다시 시작하여 변경 사항을 적용합니다.
이제 Roo Code에서 Chrome MCP 도구를 사용하여 브라우저를 제어할 수 있습니다.

사용 가능한 도구

서버는 브라우저 제어를 위해 다음과 같은 도구를 제공합니다.

탐색하다

특정 URL로 이동합니다.

매개변수:

url (문자열): 이동할 URL

딸깍 하는 소리

특정 좌표를 클릭하세요.

매개변수:

x (숫자): X 좌표
y (숫자): Y 좌표

유형

현재 포커스에 텍스트를 입력합니다.

매개변수:

text (문자열): 입력할 텍스트

클릭요소

페이지 정보에서 인덱스를 기준으로 요소를 클릭합니다.

매개변수:

selector (문자열): 요소 인덱스(예: 첫 번째 요소의 경우 "0")

getText

CSS 선택기를 사용하여 요소의 텍스트 콘텐츠를 가져옵니다.

매개변수:

selector (문자열): 요소를 찾는 CSS 선택기

getPageInfo

대화형 요소와 텍스트 노드를 포함한 페이지에 대한 의미적 정보를 얻습니다.

getPageState

URL, 제목, 스크롤 위치, 뷰포트 크기를 포함한 현재 페이지 상태를 가져옵니다.

용법

서버는 SSE 전송을 사용하는 모델 컨텍스트 프로토콜을 구현합니다. 다음 위치에서 서버에 연결하세요.

SSE 엔드포인트: http://localhost:3000/sse-cursor
메시지 엔드포인트: http://localhost:3000/message?sessionId=...

Roo Code와 함께 사용하는 경우 MCP 설정 파일의 구성에 따라 자동으로 연결이 처리됩니다.

개발

핫 리로딩을 사용하여 개발 모드에서 서버를 실행하려면:

bun dev

이는 Bun의 내장 감시 모드를 사용하여 파일이 변경되면 서버를 자동으로 다시 시작합니다.

특허

MIT