Googleカスタム検索APIとWebページコンテンツ抽出機能を使用してWeb検索機能を提供するモデルコンテキストプロトコルサーバー。

セットアップ

Google API キーと検索エンジン ID の取得

1。 Googleクラウドプロジェクトを作成します。

• Googleクラウドコンソールに行く
• 新しいプロジェクトを作成するか、既存のプロジェクトを選択して下さい
• プロジェクトの課金を有効にします

2. カスタム検索APIを有効にする:

• APIライブラリに行く
• 「カスタム検索API」を検索
• 「有効」をクリックします

3. APIのキーを得て下さい:

• クレデンシャルに行く
• 「認証」>「APIキー」をクリックします。
• APIキーのコピー
• (オプション) API キーをカスタム検索 API に制限する

4. カスタム検索エンジンを作成します。

• プログラム可能な検索エンジンに行く
• 検索したいサイトを入力してください(一般的なウェブ検索のためにwww.google.comを使用してください)
• 「作成」をクリック
• 次のページで、「カスタマイズ」をクリックします
• 設定では、「Web全体を検索」を有効にします。
• 検索エンジンID(cx)をコピー

開発

依存関係をインストール:

サーバの構築:

自動再構築による開発のため:

##特徴

###検索ツール Googleカスタム検索APIを使用してWeb検索を実行します。

• ウェブまたは特定のサイト全体を検索する
• 結果の制御数(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",