Browserbase

Browserbase MCP 서버

보관됨

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

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

모델 컨텍스트 프로토콜(MCP)은 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의 두 가지 전송 방식을 지원합니다. 서버를 최대 용량으로 활용하려면 호스팅 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 구성 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 구성 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 인증 ID 활성화 (Scale Plan 사용자만 해당)
--advancedStealth	--verified의 사용 중단된 별칭
--keepAlive	Browserbase 연결 유지 세션 활성화
--contextId <contextId>	사용할 Browserbase 컨텍스트 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.