Google Search MCP 서버

이 프로젝트는 AI 어시스턴트에 Google 검색 API 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

개요

Google Search MCP 서버는 AI 어시스턴트가 Google 검색 API를 사용하여 웹 검색을 수행할 수 있게 해주는 도구입니다.

Related MCP server: Scrapeless MCP Server

기능

• Google 검색 API를 사용한 웹 검색

• 검색 결과를 JSON 형식으로 반환

• 최대 20개의 검색 결과 검색

요건

• 파이썬 3.12 이상

• Google Custom Search Engine ID

• Google API 키

설치

1. 리포지토리를 복제합니다.

git clone https://github.com/yourusername/google-search-mcp-server.git
cd google-search-mcp-server

2. 종속성을 설치합니다.

pip install -e .

3. 환경 변수를 설정합니다.

.env.sample 파일을 .env 에 복사하고 필요한 API 키를 추가합니다.

cp .env.sample .env

.env 파일을 편집하여 다음 값을 설정합니다.

GOOGLE_CSE_ID=あなたのGoogleカスタム検索エンジンID
GOOGLE_API_KEY=あなたのGoogleAPIキー

사용방법

서버를 시작하려면:

python app.py

그러면 Gradio 인터페이스가 시작되고 MCP 서버 역할을 합니다.

MCP와의 통합

이 서버는 Model Context Protocol(MCP)을 사용하여 AI 어시스턴트와 통합됩니다.

API 참조

perform_web_search

perform_web_search(query: str, num_results: int = 10)

매개변수 :

• query (str): 검색어(최대 400자, 50단어)

• num_results (int): 결과 수(1-20, 기본값 10)

반환값 :

• str : JSON 형식 검색 결과