Skip to main content
Glama
Richard-Weiss

Google Custom Search Engine MCP Server

Google 맞춤 검색 엔진 MCP 서버

CSE(맞춤 검색 엔진)를 사용하여 검색 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 일반 Google 검색어를 입력하고 검색 결과를 반환할 수 있습니다.

이 도구는 검색 결과 자체만 반환하고 콘텐츠는 반환하지 않습니다. 검색 결과에서 콘텐츠를 추출하려면 mcp-server-fetch 와 같은 다른 서버와 함께 사용해야 합니다. 또한, 다른 도구와 함께 사용하여 일종의 "심층 검색"이나 전반적인 도구 체이닝을 활성화할 수도 있습니다.

무료 할당량은 하루 100회 검색(도구 호출 1회 = 검색 1회)입니다. 청구를 설정하지 않고 사용 사례에 충분하지 않은 경우 다른 서버를 사용하는 것이 좋습니다.

대장간 배지

사용 가능한 도구

  • google_search - 검색어를 사용하여 사용자 지정 검색 엔진을 검색하고 각 결과의 제목, 링크, 스니펫이 포함된 결과 목록을 반환합니다.

    • search_term (문자열, 필수): 검색할 검색어로, 일반 Google 검색의 쿼리 매개변수 q 와 같습니다.

Related MCP server: DuckDuckGo Web Search MCP Server

환경 변수

  • API_KEY (필수): 사용자 정의 검색 엔진의 API 키입니다.

  • ENGINE_ID (필수): 사용자 정의 검색 엔진의 엔진 ID입니다.

  • SERVICE_NAME (필수/선택): 서비스 이름입니다. 이름을 변경하지 않은 경우 비워 둡니다(customsearch).

  • COUNTRY_REGION (선택 사항): 검색 결과를 특정 국가에서 생성된 문서로 제한합니다. 유효한 값은 국가 매개변수 값을 참조하세요.

  • GEOLOCATION (선택 사항, 기본값 "us"): 검색을 수행하는 최종 사용자의 지리적 위치입니다. 유효한 값은 지리적 위치 매개변수 값을 참조하세요.

  • RESULT_LANGUAGE (선택 사항, 기본값 "lang_en"): 검색 결과의 언어입니다. 유효한 값은 CSE 쿼리 매개변수(lr)를 참조하세요.

  • RESULT_NUM (선택 사항, 기본값 10): 반환할 검색 결과 수입니다. 범위는 1~10입니다.

CSE 설정

사용자 정의 검색 엔진을 만드는 것은 비교적 쉽고, 완전히 무료이며 5분 이내에 완료할 수 있습니다.

  1. https://console.cloud.google.com/ 으로 이동하여 새 프로젝트를 만드세요. 예를 들어 "Claude CSE"라고 이름을 지정하세요.

  2. 프로젝트를 선택하고 검색창에서 "사용자 정의 검색 API"를 검색하세요.

  3. 검색 결과를 클릭하고 "활성화"를 클릭합니다.

  4. 자격 증명 탭을 클릭하고 새 API 키를 만듭니다.

  5. https://programmablesearchengine.google.com 으로 이동하여 새로운 맞춤 검색 엔진을 만드세요.

  6. 새로운 검색 엔진을 만들고 이름을 지정하세요. 이름은 SERVICE_NAME과 관련이 없어야 합니다.

  7. 일반적인 Google 검색 환경을 원하면 "전체 웹 검색"을 선택하세요.

  8. "만들기"를 클릭하고 js 코드에서 엔진 ID를 복사하거나, 사용자 지정을 클릭하고 개요에서 가져옵니다.

  9. 원하는 대로 검색 엔진을 사용자 지정할 수 있습니다.

기본 할당량을 사용하면 하루에 100건의 검색이 무료로 제공됩니다. 예를 들어 10개의 결과가 나오더라도 도구 호출에는 검색 1건만 비용이 청구됩니다.

설치

uv 사용(권장)

uv 사용하면 별도의 설치가 필요하지 않습니다. uvx 사용하여 mcp-google-cse를 직접 실행합니다.

PIP 사용

또는 pip를 통해 mcp-google-cse 설치할 수 있습니다.

지엑스피1

설치 후 다음을 사용하여 스크립트로 실행할 수 있습니다.

python -m mcp-google-cse

Smithery를 통해 설치

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

npx -y @smithery/cli install @Richard-Weiss/mcp-google-cse --client claude

구성

Claude 앱 구성

claude_desktop_config.json 에 다음을 추가하세요:

uvx 사용(어떤 것을 선택해야 할지 모르는 경우 이것을 사용하세요)

"mcp-google-cse": { "command": "uvx", "args": ["mcp-google-cse"], "env": { "API_KEY": "", "ENGINE_ID": "" } }

pip 설치 사용

"mcp-google-cse": { "command": "python", "args": ["-m", "mcp-google-cse"], "env": { "API_KEY": "", "ENGINE_ID": "" } }

지역적으로 실행

"mcp-google-cse": { "command": "uv", "args": [ "--directory", "{{Path to the cloned repo", "run", "mcp-google-cse" ], "env": { "API_KEY": "", "ENGINE_ID": "" } }

예시 결과

google_search("2024-11-01 이후의 MCP는 무엇입니까?") 결과:

[ { "title": "Can someone explain MCP to me? How are you using it? And what ...", "link": "https://www.reddit.com/r/ClaudeAI/comments/1h55zxd/can_someone_explain_mcp_to_me_how_are_you_using/", "snippet": "Dec 2, 2024 ... Comments Section ... MCP essentially allows you to give Claude access to various external systems. This can be files on your computer, an API, a browser, a ..." }, { "title": "Introducing the Model Context Protocol \\ Anthropic", "link": "https://www.anthropic.com/news/model-context-protocol", "snippet": "Nov 25, 2024 ... The Model Context Protocol (MCP) is an open standard for connecting AI assistants to the systems where data lives, including content repositories, ..." }, { "title": "3.5 Sonnet + MCP + Aider = Complete Game Changer : r ...", "link": "https://www.reddit.com/r/ChatGPTCoding/comments/1hwn6qd/35_sonnet_mcp_aider_complete_game_changer/", "snippet": "Jan 8, 2025 ... Really cool stuff. For those out of the loop here are some MCP servers. You can give your Claude chat (in the desktop version, or in a tool like Cline) ..." }, { "title": "Announcing Spring AI MCP: A Java SDK for the Model Context ...", "link": "https://spring.io/blog/2024/12/11/spring-ai-mcp-announcement", "snippet": "Dec 11, 2024 ... This SDK will enable Java developers to easily connect with an expanding array of AI models and tools while maintaining consistent, reliable integration ..." }, { "title": "Implementing a MCP server in Quarkus - Quarkus", "link": "https://quarkus.io/blog/mcp-server/", "snippet": "6 days ago ... The Model Context Protocol (MCP) is an emerging standard that enables AI models to safely interact with external tools and resources. In this tutorial, I'll ..." }, { "title": "mark3labs/mcp-go: A Go implementation of the Model ... - GitHub", "link": "https://github.com/mark3labs/mcp-go", "snippet": "Dec 18, 2024 ... A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools." }, { "title": "MCP enables Claude to Build, Run and Test Web Apps by Looking ...", "link": "https://wonderwhy-er.medium.com/mcp-enable-claude-to-build-run-and-test-web-apps-using-screenshots-3ae06aea6c4a", "snippet": "Dec 18, 2024 ... How to Replicate My Experiment on Your Machine. If you're ready to dive into setting up MCP for Claude, follow these steps: ... 2. Download the Project: ... 3." }, { "title": "MCP definition and meaning | Collins English Dictionary", "link": "https://www.collinsdictionary.com/dictionary/english/mcp", "snippet": "2 days ago ... 2 meanings: male chauvinist pig → informal, derogatory a man who exhibits male chauvinism Abbreviation: MCP.... Click for more definitions." }, { "title": "What is Anthropic's New MCP Standard and How Can It Improve ...", "link": "https://dappier.medium.com/what-is-anthropics-new-mcp-standard-and-how-can-it-improve-your-ai-agent-be6f6c72eb6a", "snippet": "Nov 26, 2024 ... Anthropic has released a new protocol, MCP, for connecting AI agents to data sets. This blog explores when and why developers might use MCP to improve their ..." }, { "title": "Mostafa Gharib on LinkedIn: What is MCP and how it works", "link": "https://www.linkedin.com/posts/mostafa-gharib_what-is-mcp-and-how-it-works-activity-7274301560594026497-p_yq", "snippet": "Dec 15, 2024 ... ... MCP Host can use. (Bonus: SDKs in Python and TypeScript make it easy to build these servers!) 2️⃣ MCP Clients These interact with MCP Servers via the protocol." } ]
One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Richard-Weiss/mcp-google-cse'

If you have feedback or need assistance with the MCP directory API, please join our Discord server