구글 검색 MCP

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

특징

봇 우회 방지 : 브라우저 지문 스푸핑과 실제 사용자 동작 시뮬레이션을 사용하여 감지를 방지합니다.
자동 CAPTCHA 처리 : CAPTCHA에 직면하면 헤드 모드로 전환하여 사용자가 인증을 완료할 수 있도록 합니다.
상태 지속성 : 반복적인 검증 필요성을 줄이기 위해 브라우저 세션 상태를 저장합니다.
적응성 : Google 검색 페이지의 변경 사항에 적응하기 위해 여러 선택기 조합을 사용합니다.
MCP 통합 : AI 어시스턴트와의 쉬운 통합을 위한 모델 컨텍스트 프로토콜 구현
다국어 지원 : 다양한 언어 및 지역의 검색 결과를 지원합니다.

커서와 함께 사용

설치 - 글로벌

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

지엑스피1

커서 IDE에서

Cursor Settings > MCP 로 이동하세요
+ Add New MCP Server 클릭하세요
양식을 작성하세요:
- 이름: 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입니다.

작동 원리

이 도구는 Playwright를 사용하여 Chromium 브라우저를 제어하여 Google 검색을 수행합니다.
브라우저 지문 스푸핑 및 실제 사용자 동작 시뮬레이션을 통해 봇 감지를 방지합니다.
CAPTCHA 검증을 만나면 자동으로 사용자 완료를 위한 헤드모드로 전환됩니다.
검색 결과를 추출하여 구조화된 형식으로 반환합니다.
이후 검색에서 재사용할 수 있도록 브라우저 상태를 저장합니다.

고급 구성

브라우저 상태 파일

기본적으로 브라우저 상태는 사용자 홈 디렉터리의 .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 또는 기타 검색 엔진에 접속할 경우 관련 서비스 약관 및 법적 규정을 준수해야 합니다. 작성자는 이 도구 사용으로 인해 발생하는 문제에 대해 책임을 지지 않습니다.

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

봇 방지 메커니즘을 우회하면서 Google 검색을 수행하고 결과를 추출하는 Playwright 기반 도구로, AI 도우미에게 실시간 검색 기능을 제공합니다.

Related MCP Servers

Tavily MCP Serverofficial
tavily-ai
A
security
A
license
A
quality
This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
Last updated -
2
8,040
437
JavaScript
MIT License
ReActMCP Web Search
mshojaei77
-
security
F
license
-
quality
An MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.
Last updated -
119
Python
Exa MCP Server
geezerrrr
-
security
A
license
-
quality
A server that enables AI assistants like Claude to perform web searches using the Exa AI Search API, providing real-time web information in a safe and controlled way.
Last updated -
1,930
MIT License
Fetcher MCP
everford
A
security
A
license
A
quality
A server that allows fetching web page content using Playwright headless browser with AI-powered capabilities for efficient information extraction.
Last updated -
2
663
3
TypeScript
MIT License

View all related MCP servers

Google Search MCP