G-서치 MCP

여러 키워드를 동시에 사용하여 병렬 검색을 가능하게 하는 Google 검색을 위한 강력한 MCP 서버입니다.

이 프로젝트는 google-search 에서 수정되었습니다.

장점

병렬 검색 : 구글에서 여러 키워드로 동시에 검색을 지원하여 검색 효율성을 향상시킵니다.
브라우저 최적화 : 효율적인 병렬 검색을 위해 단일 브라우저 인스턴스에서 여러 탭을 엽니다.
자동 검증 처리 : 필요할 때 CAPTCHA를 지능적으로 감지하고 사용자 검증을 위해 눈에 보이는 브라우저 모드를 활성화합니다.
사용자 행동 시뮬레이션 : 검색 엔진에서 감지될 가능성을 줄이기 위해 실제 사용자 검색 패턴을 시뮬레이션합니다.
구조화된 데이터 : 쉬운 처리 및 분석을 위해 JSON 형식으로 구조화된 검색 결과를 반환합니다.
구성 가능한 매개변수 : 검색 결과 제한, 시간 초과 설정, 로캘 설정 등 다양한 매개변수 구성을 지원합니다.

Related MCP server: SerpApi MCP Server

빠른 시작

npx로 직접 실행:

지엑스피1

최초 설정 - 터미널에서 다음 명령을 실행하여 필요한 브라우저를 설치하세요.

npx playwright install chromium

디버그 모드

--debug 옵션을 사용하면 디버그 모드(브라우저 창 표시)에서 실행할 수 있습니다.

npx -y g-search-mcp --debug

MCP 구성

Claude Desktop에서 이 MCP 서버를 구성하세요.

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "g-search": { "command": "npx", "args": ["-y", "g-search-mcp"] } } }

특징

search - 여러 키워드로 Google 검색을 실행하고 결과를 반환합니다.
- Playwright 브라우저를 사용하여 검색을 수행합니다.
- 다음 매개변수를 지원합니다.
  - queries : 실행할 검색 쿼리 배열(필수 매개변수)
  - limit : 쿼리당 반환할 최대 결과 수, 기본값은 10입니다.
  - timeout : 페이지 로딩 시간 초과(밀리초), 기본값은 60000(60초)입니다.
  - noSaveState : 브라우저 상태를 저장하지 않을지 여부, 기본값은 false입니다.
  - locale : 검색 결과에 대한 로케일 설정, 기본값은 en-US입니다.
  - debug : 디버그 모드(브라우저 창 표시)를 활성화할지 여부, 명령줄의 --debug 플래그를 무시합니다.

사용 예 :

Use the search tool to search for "machine learning" and "artificial intelligence" on Google

응답 예시 :

{ "searches": [ { "query": "machine learning", "results": [ { "title": "What is Machine Learning? | IBM", "link": "https://www.ibm.com/topics/machine-learning", "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy." }, ... ] }, { "query": "artificial intelligence", "results": [ { "title": "What is Artificial Intelligence (AI)? | IBM", "link": "https://www.ibm.com/topics/artificial-intelligence", "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind." }, ... ] } ] }

사용 팁

특수 웹사이트 시나리오 처리

검색 매개변수 조정

검색 결과 수량 : 더 많은 검색 결과를 보려면:
Please return the top 20 search results for each keyword
이렇게 하면 limit: 20 매개변수로 설정됩니다.
시간 초과 기간 증가 : 로딩이 느린 상황의 경우:
Please set the page loading timeout to 120 seconds
이렇게 하면 timeout 매개변수가 120000밀리초로 조정됩니다.

로케일 설정 조정

검색 지역 변경 : 다른 로케일 설정을 지정하세요.
Please use Chinese locale (zh-CN) for searching
이렇게 하면 locale: "zh-CN" 매개변수가 설정됩니다.

디버깅 및 문제 해결

디버그 모드 활성화

동적 디버그 활성화 : 특정 검색 작업 중에 브라우저 창을 표시하려면:
Please enable debug mode for this search operation
--debug 플래그 없이 서버를 시작한 경우에도 debug: true 로 설정됩니다.

설치

필수 조건

Node.js 18 이상
NPM 또는 Yarn

소스에서 설치

저장소를 복제합니다.

git clone https://github.com/jae-jae/g-search-mcp.git cd g-search-mcp

종속성 설치:

npm install

Playwright 브라우저를 설치하세요:

npm run install-browser

서버를 빌드하세요:

npm run build

개발

자동 재구축(개발 모드)

npm run watch

디버깅을 위한 MCP Inspector 사용

npm run inspector

특허

MIT 라이선스 에 따라 라이센스됨

Deploy Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

search

G-Search MCP