mcp-서버-브라우저베이스

Playwright Browserbase MCP 서버

씌우다

모델 컨텍스트 프로토콜(MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 지원하는 개방형 프로토콜입니다. AI 기반 IDE를 구축하거나, 채팅 인터페이스를 개선하거나, 맞춤형 AI 워크플로를 만드는 경우, MCP는 LLM을 필요한 컨텍스트에 연결하는 표준화된 방법을 제공합니다.

MCP json에서 설정하는 방법

NPM에 호스팅된 서버를 사용할 수도 있고, 이 저장소를 복제하여 완전히 로컬에서 실행할 수도 있습니다.

NPM에서 실행하려면(권장)

MCP Config JSON으로 이동하여 Browserbase 서버를 추가하세요.

지엑스피1

이제 끝입니다! MCP 클라이언트를 다시 로드하면 Claude가 Browserbase를 사용할 수 있습니다.

100% 로컬로 실행하려면:

# Clone the Repo 
git clone https://github.com/browserbase/mcp-server-browserbase.git

# Install the dependencies in the proper directory and build the project
cd browserbase
npm install && npm run build

그런 다음 MCP Config JSON에서 서버를 실행합니다. 로컬에서 실행하려면 STDIO를 사용하거나 SSE를 통해 셀프 호스팅할 수 있습니다.

스튜디오:

MCP Config JSON 파일에 다음을 추가하세요.

{
"mcpServers": {
   "browserbase": {
      "command" : "node",
      "args" : ["/path/to/mcp-server-browserbase/browserbase/cli.js"],
      "env": {
         "BROWSERBASE_API_KEY": "",
         "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

사회경제개발부:

터미널에서 다음 명령을 실행하세요. 원하는 플래그(아래 옵션 참조)를 추가하여 구성을 사용자 지정할 수 있습니다.

   node cli.js --port 8931

그런 다음 MCP Config JSON 파일에 다음을 넣으세요.

   {
      "mcpServers": {
         "browserbase": {
            "url": "http://localhost:8931/sse",
            "env": {
               "BROWSERBASE_API_KEY": "",
               "BROWSERBASE_PROJECT_ID": ""
            }
         }
      }
   }

그런 다음 MCP 클라이언트를 다시 로드하면 사용할 수 있습니다!

플래그 설명:

Browserbase MCP 서버는 다음 명령줄 플래그를 허용합니다.

깃발	설명
`--browserbaseApiKey <key>`	인증을 위한 Browserbase API 키
`--browserbaseProjectId <id>`	Browserbase 프로젝트 ID
`--proxies`	세션에 대해 Browserbase 프록시를 활성화합니다.
`--advancedStealth`	Browserbase Advanced Stealth 활성화(Scale Plan 사용자만 해당)
`--contextId <contextId>`	사용할 Browserbase Context ID를 지정하세요
`--persist [boolean]`	Browserbase 컨텍스트를 유지할지 여부(기본값: true)
`--port <port>`	HTTP/SSE 전송을 수신할 포트
`--host <host>`	서버를 바인딩할 호스트(기본값: localhost, 모든 인터페이스에 0.0.0.0 사용)
`--cookies [json]`	브라우저에 삽입할 쿠키의 JSON 배열
`--browserWidth <width>`	브라우저 뷰포트 너비(기본값: 1024)
`--browserHeight <height>`	브라우저 뷰포트 높이(기본값: 768)

이러한 플래그는 CLI에 직접 전달하거나 MCP 구성 파일에서 구성할 수 있습니다.

메모:

현재 이러한 플래그는 로컬 서버(npx @browserbasehq/mcp)에서만 사용할 수 있습니다.

플래그 및 예제 구성

프록시

프록시 에 대한 문서는 다음과 같습니다.

STDIO에서 프록시를 사용하려면 MCP Config에서 --proxies 플래그를 설정하세요.

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : ["@browserbasehq/mcp", "--proxies"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

고급 스텔스

고급 스텔스 에 대한 문서는 다음과 같습니다.

STDIO에서 프록시를 사용하려면 MCP Config에서 --advancedStealth 플래그를 설정하세요.

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : ["@browserbasehq/mcp", "--advancedStealth"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

맥락

컨텍스트 에 대한 문서는 다음과 같습니다.

STDIO에서 컨텍스트를 사용하려면 MCP Config에서 --contextId 플래그를 설정하세요.

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : ["@browserbasehq/mcp", "--contextId", "<YOUR_CONTEXT_ID>"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

쿠키 주입

쿠키를 주입해야 하는 이유는 무엇인가요? 현재 저희 컨텍스트 API는 영구 쿠키에서는 작동하지만 세션 쿠키에서는 작동하지 않습니다. 따라서 영구 인증이 작동하지 않는 경우가 있습니다(저희는 이 기능을 추가하기 위해 최선을 다하고 있습니다).

MCP Config에 cookies.json을 추가하여 쿠키를 MCP에 표시할 수 있습니다.

STDIO에서 프록시를 사용하려면 MCP Config에서 --proxies 플래그를 설정하세요. 쿠키 JSON은 Playwright 쿠키 유형이어야 합니다.

{
   "mcpServers": {
      "browserbase" {
         "command" : "npx",
         "args" : [
            "@browserbasehq/mcp", "--cookies", 
            '{
               "cookies": json,
            }'
         ],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

브라우저 뷰포트 크기 조정

브라우저 세션의 기본 뷰포트 크기는 1024 x 768입니다. browserWidth 및 browserHeight 플래그를 사용하여 브라우저 뷰포트 크기를 조정할 수 있습니다.

사용자 지정 브라우저 크기 조정에 사용하는 방법은 다음과 같습니다. 16:9 종횡비(예: 1920 x 1080, 1280, 720, 1024 x 768)를 사용하는 것이 좋습니다.

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : [
            "@browserbasehq/mcp",
            "--browserHeight 1080",
            "--browserWidth 1920",
         ],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

구조

src/ : TypeScript 소스 코드
- index.ts : 메인 진입점, 환경 체크, 종료
- server.ts : MCP 서버 설정 및 요청 라우팅
- sessionManager.ts : Browserbase 세션 생성/관리를 처리합니다.
- tools/ : 도구 정의 및 구현
- resources/ : 리소스(스크린샷) 처리
- types.ts : 공유 TypeScript 유형
dist/ : 컴파일된 JavaScript 출력
tests/ : 테스트를 위한 플레이스홀더
utils/ : 유틸리티 스크립트의 플레이스홀더
Dockerfile : Docker 이미지를 빌드하기 위한 파일
구성 파일( .json , .ts , .mjs , .npmignore )

지속성을 위한 컨텍스트

이 서버는 브라우저 세션 전반에 걸쳐 쿠키, 인증 및 캐시된 데이터를 유지할 수 있는 Browserbase의 Contexts 기능을 지원합니다.

컨텍스트 생성 :
browserbase_context_create: Creates a new context, optionally with a friendly name
세션과 함께 컨텍스트 사용 :
browserbase_session_create: Now accepts a 'context' parameter with: - id: The context ID to use - name: Alternative to ID, the friendly name of the context - persist: Whether to save changes (cookies, cache) back to the context (default: true)
컨텍스트 삭제 :
browserbase_context_delete: Deletes a context when you no longer need it

컨텍스트를 이용하면 다음 작업을 훨씬 쉽게 수행할 수 있습니다.

세션 전체에서 로그인 상태 유지
캐시를 보존하여 페이지 로드 시간을 줄이세요
브라우저 지문을 재사용하여 CAPTCHA 및 감지를 방지하세요

쿠키 관리

이 서버는 또한 직접적인 쿠키 관리 기능을 제공합니다.

쿠키 추가 :
browserbase_cookies_add: Add cookies to the current browser session with full control over properties
쿠키 얻기 :
browserbase_cookies_get: View all cookies in the current session (optionally filtered by URLs)
쿠키 삭제 :
browserbase_cookies_delete: Delete specific cookies or clear all cookies from the session

이러한 도구는 다음과 같은 경우에 유용합니다.

로그인 페이지로 이동하지 않고 인증 쿠키 설정
쿠키 상태 백업 및 복원
쿠키 관련 문제 디버깅
쿠키 속성(만료일, 보안 플래그 등) 조작

TODO/로드맵

클릭, 입력, 드래그, 호버, select_option에 대한 진정한 ref 기반 상호작용 로직을 구현합니다.
ref 사용하여 요소별 스크린샷을 구현합니다.
더 많은 표준 MCP 도구(탭, 탐색 등)를 추가합니다.
테스트를 추가합니다.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

이 서버는 Browserbase, Puppeteer, Stagehand를 사용하여 클라우드 브라우저 자동화 기능을 제공합니다. LLM은 이 서버를 통해 클라우드 브라우저 환경에서 웹 페이지와 상호 작용하고, 스크린샷을 찍고, JavaScript를 실행할 수 있습니다.

Related MCP Servers

Playwright MCP Server
lebrodus
A
security
F
license
A
quality
A server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.
Last updated -
12
9,457
1
TypeScript
Puppeteer MCP Server
jwaldor
A
security
F
license
A
quality
Enables LLMs to perform web browsing tasks, take screenshots, and execute JavaScript using Puppeteer for browser automation.
Last updated -
4
15,502
1
JavaScript
MCP Puppeteer Linux Server
PhialsBasement
A
security
F
license
A
quality
Enables browser automation for LLMs on Linux display servers, supporting web interaction, screenshots, and JavaScript execution in a real browser.
Last updated -
7
5
4
JavaScript
Steel Puppeteer
rdvo
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to automate web browsers using Puppeteer, allowing navigation, screenshots, form filling, and JavaScript execution in a real browser environment.
Last updated -
JavaScript
MIT License

View all related MCP servers

mcp-server-browserbase

Playwright Browserbase MCP 서버

MCP json에서 설정하는 방법

NPM에서 실행하려면(권장)

100% 로컬로 실행하려면:

스튜디오:

사회경제개발부:

플래그 설명:

메모:

플래그 및 예제 구성

프록시

고급 스텔스

맥락

쿠키 주입

브라우저 뷰포트 크기 조정

구조

지속성을 위한 컨텍스트

쿠키 관리

TODO/로드맵

Tools

Related MCP Servers

Playwright MCP Server

Puppeteer MCP Server

MCP Puppeteer Linux Server

Steel Puppeteer

Appeared in Searches

New MCP Servers

MCP directory API