Google Search MCP Server

by moritalous
Apache 2.0

Integrations

  • Manages environment variables for storing Google API credentials and configuration

  • Enables web search capabilities through Google Search API, allowing retrieval of up to 20 search results in JSON format

  • Provides the interface between AI assistants and the Google Search API functionality

Google Search MCP サーバー

このプロジェクトは、AI アシスタントに Google 検索 API 機能を提供する Model Context Protocol (MCP) サーバーです。

概要

Google Search MCP サーバーは、AI アシスタントが Google 検索 API を使用してウェブ検索を実行できるようにするツールです。Gradio と MCP を使用して、AI アシスタントと Google 検索 API の間のインターフェースを提供します。

機能

  • Google 検索 API を使用したウェブ検索
  • 検索結果の JSON 形式での返却
  • 最大 20 件の検索結果の取得

必要条件

  • Python 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
  1. 依存関係をインストールします:
pip install -e .
  1. 環境変数を設定します:

.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 アシスタントと統合されます。AI アシスタントは、このサーバーを通じて Google 検索機能にアクセスできます。

API リファレンス

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

パラメータ:

  • query (str): 検索クエリ(最大 400 文字、50 単語)
  • num_results (int): 結果の数(1〜20、デフォルト 10)

戻り値:

  • str: JSON 形式の検索結果
-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server that enables AI assistants to perform web searches using Google Search API, returning up to 20 search results in JSON format.

  1. 概要
    1. 機能
      1. 必要条件
        1. インストール
          1. 使用方法
            1. MCP との統合
              1. API リファレンス
                1. perform_web_search

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants like Claude to perform real-time web searches using the Exa AI Search API in a safe and controlled manner.
                Last updated -
                2,806
                • Apple
              • A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
                Last updated -
                1
                44
                8
                JavaScript
                • Apple
                • Linux
              • -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
                Last updated -
                3
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.
                Last updated -
                1
                75
                3
                TypeScript
                MIT License

              View all related MCP servers

              ID: pqwszp1v9d