구글 검색 MCP

Google 검색용 모델 컨텍스트 프로토콜 (MCP) 서버입니다. Playwright 기반 모델 컨텍스트 프로토콜(MCP) 도구로, 검색 엔진의 봇 방지 메커니즘을 우회하고 Google 검색을 수행하며 결과를 추출하여 Claude 및 Cursor와 같은 AI 비서에게 실시간 검색 기능을 제공합니다.

특징

• 봇 우회 방지 : 브라우저 지문 스푸핑과 실제 사용자 동작 시뮬레이션을 사용하여 감지를 방지합니다.

• 자동 CAPTCHA 처리 : CAPTCHA에 직면하면 헤드 모드로 전환하여 사용자가 인증을 완료할 수 있도록 합니다.

• 상태 지속성 : 반복적인 검증 필요성을 줄이기 위해 브라우저 세션 상태를 저장합니다.

• 적응성 : Google 검색 페이지의 변경 사항에 적응하기 위해 여러 선택기 조합을 사용합니다.

• MCP 통합 : AI 어시스턴트와의 쉬운 통합을 위한 모델 컨텍스트 프로토콜 구현

• 다국어 지원 : 다양한 언어 및 지역의 검색 결과를 지원합니다.

Related MCP server: Playread

커서와 함께 사용

설치 - 글로벌

npx를 사용하여 MCP 서버를 실행합니다.

지엑스피1

커서 IDE에서

1. Cursor Settings > MCP 로 이동하세요

2. + Add New MCP Server 클릭하세요

3. 양식을 작성하세요:

   • 이름: google-search (또는 원하는 이름)

   • 유형: command

   • 명령어: npx -y @mcp-server/google-search-mcp@latest

설치 - 프로젝트별

프로젝트에 .cursor/mcp.json 파일을 추가합니다.

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
      ]
    }
  }
}

개발

yarn install

프로젝트를 빌드하세요

yarn build

용법

MCP 서버로 실행

yarn start

MCP Inspector와 함께 사용

서버를 디버깅하려면 MCP Inspector를 사용할 수 있습니다.

# First build the project
yarn build

# Start the MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.js

매개변수

검색 도구는 다음 매개변수를 허용합니다.

• query (필수): 검색 쿼리 문자열

• limit (선택 사항): 반환할 검색 결과 수, 기본값은 10입니다.

• timeout (선택 사항): 검색 작업 시간 초과(밀리초), 기본값은 60000입니다.

• language (선택 사항): 검색 결과에 사용되는 언어(예: zh-CN, en-US, 기본값은 zh-CN)

• region (선택 사항): 검색 결과의 지역, 예: cn, com, co.jp, 기본값은 cn입니다.

작동 원리

1. 이 도구는 Playwright를 사용하여 Chromium 브라우저를 제어하여 Google 검색을 수행합니다.

2. 브라우저 지문 스푸핑 및 실제 사용자 동작 시뮬레이션을 통해 봇 감지를 방지합니다.

3. CAPTCHA 검증을 만나면 자동으로 사용자 완료를 위한 헤드모드로 전환됩니다.

4. 검색 결과를 추출하여 구조화된 형식으로 반환합니다.

5. 이후 검색에서 재사용할 수 있도록 브라우저 상태를 저장합니다.

고급 구성

브라우저 상태 파일

기본적으로 브라우저 상태는 사용자 홈 디렉터리의 .google-search-browser-state.json 파일에 저장됩니다. 매개변수를 통해 이 경로를 수정할 수 있습니다.

언어 및 지역 설정

매개변수를 통해 검색 결과에 대한 언어와 지역을 지정할 수 있습니다.

// English (US) search results
"language": "en-US", "region": "com"

// Japanese search results
"language": "ja-JP", "region": "co.jp"

// Chinese (Simplified) search results
"language": "zh-CN", "region": "cn"

노트

• 처음 사용 시 CAPTCHA 검증에 직면하면 시스템이 자동으로 헤드모드로 전환되어 검증을 완료할 수 있습니다.

• 검증 후 시스템은 상태 파일을 저장하여 후속 검색을 더욱 원활하게 해줍니다.

• 너무 빈번한 검색 요청은 Google의 속도 제한 메커니즘을 트리거할 수 있습니다.

• 이 도구는 학습 및 연구 목적으로만 사용되며 Google 서비스 약관을 준수해 주십시오.

특허

MIT

부인 성명

이 도구는 학습 및 연구 목적으로만 사용됩니다. 이 도구를 사용하여 Google 또는 기타 검색 엔진에 접속할 경우 관련 서비스 약관 및 법적 규정을 준수해야 합니다. 작성자는 이 도구 사용으로 인해 발생하는 문제에 대해 책임을 지지 않습니다.