G-서치 MCP
여러 키워드를 동시에 사용하여 병렬 검색을 가능하게 하는 Google 검색을 위한 강력한 MCP 서버입니다.
이 프로젝트는 google-search 에서 수정되었습니다.
장점
- 병렬 검색 : 구글에서 여러 키워드로 동시에 검색을 지원하여 검색 효율성을 향상시킵니다.
- 브라우저 최적화 : 효율적인 병렬 검색을 위해 단일 브라우저 인스턴스에서 여러 탭을 엽니다.
- 자동 검증 처리 : 필요할 때 CAPTCHA를 지능적으로 감지하고 사용자 검증을 위해 눈에 보이는 브라우저 모드를 활성화합니다.
- 사용자 행동 시뮬레이션 : 검색 엔진에서 감지될 가능성을 줄이기 위해 실제 사용자 검색 패턴을 시뮬레이션합니다.
- 구조화된 데이터 : 쉬운 처리 및 분석을 위해 JSON 형식으로 구조화된 검색 결과를 반환합니다.
- 구성 가능한 매개변수 : 검색 결과 제한, 시간 초과 설정, 로캘 설정 등 다양한 매개변수 구성을 지원합니다.
빠른 시작
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 로 설정됩니다.
설치
필수 조건
소스에서 설치
- 저장소를 복제합니다.
git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp
- 종속성 설치:
- Playwright 브라우저를 설치하세요:
- 서버를 빌드하세요:
개발
자동 재구축(개발 모드)
디버깅을 위한 MCP Inspector 사용
관련 프로젝트
- fetcher-mcp : Playwright 헤드리스 브라우저를 사용하여 웹 페이지 콘텐츠를 가져오는 강력한 MCP 서버입니다. 지능형 콘텐츠 추출, 병렬 처리, 리소스 최적화 등의 기능을 갖추고 있어 웹 콘텐츠 스크래핑에 이상적인 도구입니다.
특허
MIT 라이선스 에 따라 라이센스됨