MCP Google Server

mcp-google-server Google 맞춤 검색 및 웹 페이지 읽기용 MCP 서버

Google Custom Search API와 웹페이지 콘텐츠 추출 기능을 사용하여 웹 검색 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다.

설정

Google API 키 및 검색 엔진 ID 얻기

1. Google Cloud 프로젝트 만들기:
   • Google Cloud Console 로 이동
   • 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
   • 프로젝트에 대한 청구를 활성화하세요
2. 사용자 정의 검색 API 활성화:
   • API 라이브러리 로 이동
   • "사용자 정의 검색 API"를 검색하세요
   • "활성화"를 클릭하세요
3. API 키 받기:
   • 자격 증명 으로 이동
   • "자격 증명 만들기" > "API 키"를 클릭하세요.
   • API 키를 복사하세요
   • (선택 사항) API 키를 사용자 지정 검색 API로만 제한합니다.
4. 사용자 정의 검색 엔진 만들기:
   • 프로그래밍 가능한 검색 엔진 으로 이동
   • 검색하려는 사이트를 입력하세요(일반 웹 검색의 경우 www.google.com을 사용하세요)
   • "만들기"를 클릭하세요
   • 다음 페이지에서 "사용자 정의"를 클릭하세요.
   • 설정에서 "전체 웹 검색"을 활성화하세요.
   • 검색 엔진 ID(cx)를 복사하세요

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

특징

검색 도구

Google 맞춤 검색 API를 사용하여 웹 검색을 수행합니다.

• 전체 웹 또는 특정 사이트 검색
• 결과의 제어 번호(1-10)
• 제목, 링크 및 스니펫을 사용하여 구조화된 결과를 얻으세요

웹페이지 리더 도구

모든 웹 페이지에서 콘텐츠 추출:

• 웹 페이지 콘텐츠 가져오기 및 구문 분석
• 페이지 제목과 본문 추출
• 스크립트와 스타일을 제거하여 콘텐츠를 정리합니다.
• 제목, 텍스트 및 URL을 포함한 구조화된 데이터 반환

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop에 Google 맞춤 검색 서버를 자동으로 설치하는 방법:

Claude Desktop과 함께 사용하려면 Google API 자격 증명으로 서버 구성을 추가하세요.

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

용법

검색 도구

웹페이지 리더 도구

웹 페이지 리더의 응답 예:

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.