Google Custom Search API 및 웹 페이지 콘텐츠 추출 기능을 사용하여 웹 검색 기능을 제공하는 모델 Context Protocol 서버.

설치

구글 API 키 및 검색 엔진 ID 얻기

1. Google Cloud Project 만들기:

• Google Cloud 콘솔로 이동
• 새로운 프로젝트를 만들거나 기존 하나를 선택
• 프로젝트에 대한 청구

2. Enable 관례 수색 API:

• API 라이브러리 바로가기
• “Custom Search API” 검색
• "Enable"을 클릭하십시오

3. API 열쇠를 얻으십시오:

• Credentials로 이동
• "Create Credentials"을 클릭하십시오 > “API Key”
• API 키 복사
• (선택 사항) API 키만 Custom Search API에 제한

4. 사용자 정의 검색 엔진 만들기:

• 풀그릴 수색 엔진으로 이동
• 검색하려는 사이트를 입력하십시오 (일반 웹 검색을위한 www.google.com 사용)
• "Create"를 클릭하십시오
• 다음 페이지에서 "Customize"를 클릭하십시오.
• 설정에서 "전체 웹 검색"을 활성화
• 검색 엔진 ID (cx) 복사

개발

의존성 설치:

서버 구축:

auto-rebuild를 가진 발달을 위해:

특징

검색 도구

Google Custom Search API를 사용하여 웹 검색 수행:

• 전체 웹 또는 특정 사이트를 검색
• 결과 수 (1-10)

mcp-google-server A MCP Server for Google Custom Search and Webpage Reading

A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.

Setup

Getting Google API Key and Search Engine ID

1. Create a Google Cloud Project:

   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable billing for your project

2. Enable Custom Search API:

   • Go to API Library
   • Search for “Custom Search API”
   • Click “Enable”

3. Get API Key:

   • Go to Credentials
   • Click “Create Credentials” > “API Key”
   • Copy your API key
   • (Optional) Restrict the API key to only Custom Search API

4. Create Custom Search Engine:

   • Go to Programmable Search Engine
   • Enter the sites you want to search (use www.google.com for general web search)
   • Click “Create”
   • On the next page, click “Customize”
   • In the settings, enable “Search the entire web”
   • Copy your Search Engine ID (cx)

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Features

Search Tool

Perform web searches using Google Custom Search API:

• Search the entire web or specific sites
• Control number of results (1-10)
• Get structured results with title, link, and snippet

Webpage Reader Tool

Extract content from any webpage:

• Fetch and parse webpage content
• Extract page title and main text
• Clean content by removing scripts and styles
• Return structured data with title, text, and URL

Installation

Installing via Smithery

To install Google Custom Search Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

To use with Claude Desktop, add the server config with your Google API credentials:

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

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@adenot/mcp-google-search"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
      }
    }
  }
}

Usage

Search Tool

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num": 5  // optional, default is 5, max is 10
  }
}

Webpage Reader Tool

{
  "name": "read_webpage",