Hyperbrowser MCP Server

이것은 Hyperbrowser의 Model Context Protocol (MCP) 서버입니다. 웹페이지를 스크레이핑 (Scrape), 구조화된 데이터 추출 (Extract structured data), 그리고 크롤링 (Crawl) 하기 위한 다양한 도구를 제공합니다. 또한 OpenAI의 CUA, Anthropic의 Claude Computer Use, 그리고 Browser Use와 같은 범용 브라우저 에이전트 (Browser agents)에 대한 쉬운 접근을 제공합니다.

Hyperbrowser에 대한 더 자세한 정보는 여기에서 확인할 수 있습니다. Hyperbrowser API는 MCP 서버에 존재하는 기능들의 상위 집합 (Superset)을 지원합니다.

Model Context Protocol에 대한 더 자세한 정보는 여기에서 확인할 수 있습니다.

목차

• 설치 (Installation)
• 사용법 (Usage)
• 도구 (Tools)
• 설정 (Configuration)
• 라이선스 (License)

설치 (Installation)

수동 설치 (Manual Installation)

서버를 설치하려면 다음을 실행하세요:

npx hyperbrowser-mcp <YOUR-HYPERBROWSER-API-KEY>

Cursor에서 실행하기

~/.cursor/mcp.json에 다음과 같이 추가하세요:

{
  "mcpServers": {
    "hyperbrowser": {
...

Windsurf에서 실행하기

./codeium/windsurf/model_config.json에 다음과 같이 추가하세요:

{
  "mcpServers": {
    "hyperbrowser": {
...

개발 (Development)

개발 목적으로는 소스 코드에서 서버를 직접 실행할 수 있습니다.

1. 저장소 (Repository) 클론:

   git clone git@github.com:hyperbrowserai/mcp.git hyperbrowser-mcp
   cd hyperbrowser-mcp
   

2. 의존성 (Dependencies) 설치:

   npm install # 또는 yarn install
   npm run build
   

3. 서버 실행:

   node dist/server.js
   

Claude Desktop 앱

이것은 Claude Desktop 클라이언트를 위한 Hyperbrowser MCP 서버의 설정 예시입니다.

{
  "mcpServers": {
    "hyperbrowser": {
...

도구 (Tools)

• scrape_webpage - 모든 웹페이지로부터 포맷팅된 (마크다운 (markdown), 스크린샷 등) 콘텐츠를 추출합니다.
• crawl_webpages - 여러 연결된 페이지를 탐색하고 LLM 친화적으로 포맷팅된 콘텐츠를 추출합니다.
• extract_structured_data - 지저분한 HTML을 구조화된 JSON으로 변환합니다.
• search_with_bing - 웹을 쿼리하고 Bing 검색을 통해 결과를 가져옵니다.
• browser_use_agent - Browser Use 에이전트를 사용한 빠르고 가벼운 브라우저 자동화 기능을 제공합니다.
• openai_computer_use_agent - OpenAI의 CUA (Computer Use) 모델을 사용한 범용 자동화 기능을 제공합니다.
• claude_computer_use_agent - Claude의 computer use를 사용하여 복잡한 브라우저 작업을 수행합니다.
• create_profile - 새로운 영구적인 Hyperbrowser 프로필을 생성합니다.
• delete_profile - 기존의 영구적인 Hyperbrowser 프로필을 삭제합니다.
• list_profiles - 기존의 영구적인 Hyperbrowser 프로필 목록을 나열합니다.

Smithery를 통한 설치

Smithery를 통해 Claude Desktop용 Hyperbrowser MCP 서버를 자동으로 설치하려면 다음 명령어를 사용하세요:

npx -y @smithery/cli install @hyperbrowserai/mcp --client claude

리소스 (Resources)

이 서버는 resources 메서드를 통해 hyperbrowser에 대한 문서를 제공합니다. 리소스에 대한 디스커버리 (discovery)가 가능한 모든 클라이언트는 이에 접근할 수 있습니다.

라이선스 (License)

이 프로젝트는 MIT 라이선스 (MIT License) 하에 배포됩니다.