Browserbase MCP

Browserbase MCP 서버
보관됨
이 저장소는 보관되었으며 더 이상 유지 관리되지 않습니다.

원래 참조 구현으로 게시되었으며 역사적 목적으로 보존됩니다. Browserbase의 현재 프로덕션 서비스나 구현을 대표하는 것으로 해석되어서는 안 됩니다.

MCP(Model Context Protocol)는 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다. AI 기반 IDE를 구축하든, 채팅 인터페이스를 개선하든, 사용자 정의 AI 워크플로를 만들든, MCP는 LLM을 필요한 컨텍스트와 연결하는 표준화된 방법을 제공합니다.

이 서버는 Browserbase와 Stagehand를 사용하여 클라우드 브라우저 자동화 기능을 제공합니다. 이를 통해 LLM은 웹 페이지와 상호 작용하고, 정보를 추출하며, 자동화된 작업을 수행할 수 있습니다.

이것은 동일한 도구와 기능을 갖춘 Browserbase 호스팅 MCP 서버의 자체 호스팅 가능한 버전입니다. 가장 쉬운 설정을 위해 호스팅 버전을 사용할 것을 권장합니다.

도구
이 서버는 호스팅된 Browserbase MCP 서버와 일치하는 6개의 도구를 제공합니다:

도구
설명
입력

start
Browserbase 세션 생성 또는 재사용
(없음)

end
현재 Browserbase 세션 종료
(없음)

navigate
URL로 이동
{ url: string }

act
페이지에서 작업 수행
{ action: string }

observe
페이지에서 실행 가능한 요소 관찰
{ instruction: string }

extract
페이지에서 데이터 추출
{ instruction?: string }

설정 방법
현재 MCP 서버에 대해 STDIO와 SHTTP의 2가지 전송을 지원합니다. 서버를 최대한 활용하려면 호스팅 MCP 서버와 함께 SHTTP를 사용할 것을 권장합니다.

SHTTP (호스팅 MCP):
https://mcp.browserbase.com/mcp 에서 Browserbase 호스팅 MCP 서버를 사용하세요. 이것이 시작하는 가장 쉬운 방법입니다 -- 저희가 서버를 호스팅하고 Stagehand에서 가장 성능이 좋은 모델인 Gemini의 LLM 비용을 제공합니다.

전체 설정 지침은 Browserbase MCP 문서를 참조하세요.

클라이언트가 SHTTP를 지원하는 경우:

{
"mcpServers" : {
"browserbase" : {
"type" : " http " ,
"url" : " https://mcp.browserbase.com/mcp "
}
}
}
클라이언트가 SHTTP를 지원하지 않는 경우:

{
"mcpServers" : {
"browserbase" : {
"command" : " npx " ,
"args" : [ " mcp-remote " , " https://mcp.browserbase.com/mcp " ]
}
}
}
STDIO (자체 호스팅):
NPM에 호스팅된 서버를 사용하거나 이 저장소를 복제하여 완전히 로컬에서 실행할 수 있습니다.

참고: 다른 모델을 사용하려면 args에 --modelName을 추가하고 해당 키를 인수로 제공해야 합니다. 자세한 내용은 아래를 참조하세요.

NPM을 통해 실행 (권장)
MCP Config JSON으로 이동하여 Browserbase 서버를 추가하세요:

{
"mcpServers" : {
"browserbase" : {
"command" : " npx " ,
"args" : [ " @browserbasehq/mcp " ],
"env" : {
"BROWSERBASE_API_KEY" : " " ,
"BROWSERBASE_PROJECT_ID" : " " ,
"GEMINI_API_KEY" : " "
}
}
}
}
그게 전부입니다! MCP 클라이언트를 다시 로드하면 준비가 완료됩니다.

100% 로컬로 실행하려면:
옵션 1: 직접 설치
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build
옵션 2: Docker
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .
그런 다음 MCP Config JSON에서 서버를 실행하세요:

직접 설치 사용
{
"mcpServers" : {
"browserbase" : {
"command" : " node " ,
"args" : [ " /path/to/mcp-server-browserbase/cli.js " ],
"env" : {
"BROWSERBASE_API_KEY" : " " ,
"BROWSERBASE_PROJECT_ID" : " " ,
"GEMINI_API_KEY" : " "
}
}
}
}
Docker 사용
{
"mcpServers" : {
"browserbase" : {
"command" : " docker " ,
"args" : [
" run " ,
" --rm " ,
" -i " ,
" -e " ,
" BROWSERBASE_API_KEY " ,
" -e " ,
" BROWSERBASE_PROJECT_ID " ,
" -e " ,
" GEMINI_API_KEY " ,
" mcp-browserbase "
],
"env" : {
"BROWSERBASE_API_KEY" : " " ,
"BROWSERBASE_PROJECT_ID" : " " ,
"GEMINI_API_KEY" : " "
}
}
}
}
구성
Browserbase MCP 서버는 다음 명령줄 플래그를 허용합니다:

플래그
설명

--proxies
세션에 Browserbase 프록시 활성화

--verified
Browserbase Verified Identity 활성화 (Scale 플랜 사용자 전용)

--advancedStealth
--verified의 사용 중단된 별칭

--keepAlive
Browserbase Keep Alive 세션 활성화

--contextId <contextId>
사용할 Browserbase Context ID 지정

--persist
Browserbase 컨텍스트 유지 여부 (기본값: true)

--port <port>
HTTP/SHTTP 전송을 위해 수신 대기할 포트

--host <host>
서버를 바인딩할 호스트 (기본값: localhost, 모든 인터페이스의 경우 0.0.0.0 사용)

--browserWidth <width>
브라우저 뷰포트 너비 (기본값: 1024)

--browserHeight <height>
브라우저 뷰포트 높이 (기본값: 768)

--modelName <model>
Stagehand에 사용할 모델 (기본값: google/gemini-2.5-flash-lite)

--modelApiKey <key>
사용자 정의 모델 제공자용 API 키 (사용자 정의 모델 사용 시 필수)

--experimental
실험적 기능 활성화 (기본값: false)

이 플래그들은 CLI에 직접 전달하거나 MCP 구성 파일에서 설정할 수 있습니다.

참고: 이 플래그들은 자체 호스팅 서버(npx @browserbasehq/mcp 또는 Docker)에서만 사용할 수 있습니다.

모델 구성
Stagehand는 기본적으로 Google의 Gemini 2.5 Flash Lite 모델을 사용하지만, GPT-4o, Claude 또는 다른 제공자와 같은 다른 모델을 사용하도록 구성할 수 있습니다.

중요: 사용자 정의 모델(기본값이 아닌)을 사용할 때는 --modelApiKey 플래그를 사용하여 해당 모델 제공자의 자체 API 키를 제공해야 합니다.

{
"mcpServers" : {
"browserbase" : {
"command" : " npx " ,
"args" : [
" @browserbasehq/mcp " ,
" --modelName " ,
" anthropic/claude-sonnet-4.5 " ,
" --modelApiKey " ,
" your-anthropic-api-key "
],
"env" : {
"BROWSERBASE_API_KEY" : " " ,
"BROWSERBASE_PROJECT_ID" : " "
}
}
}
}
참고: 모델은 Stagehand에서 지원되어야 합니다. 여기에서 문서를 확인하세요.

링크

Browserbase MCP 문서
MCP 문서
MCP 사양
Stagehand 문서

라이선스
Apache 2.0 라이선스에 따라 라이선스가 부여됩니다.

Copyright 2025 Browserbase, Inc.