mcp-google-server Googleカスタム検索とウェブページ閲覧用のMCPサーバー

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

設定

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

1. Google Cloud プロジェクトを作成します。

   • Google Cloud Consoleに移動

   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください

   • プロジェクトの課金を有効にする

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

   • APIライブラリへ移動

   • 「カスタム検索API」を検索

   • 「有効にする」をクリックします

3. APIキーを取得:

   • 資格情報へ移動

   • 「認証情報を作成」>「APIキー」をクリックします

   • APIキーをコピーする

   • （オプション）APIキーをカスタム検索APIのみに制限する

4. カスタム検索エンジンを作成する:

   • プログラム可能な検索エンジンへ

   • 検索したいサイトを入力してください（一般的なウェブ検索にはwww.google.comを使用してください）

   • 「作成」をクリック

   • 次のページで「カスタマイズ」をクリックします

   • 設定で「ウェブ全体を検索」を有効にします

   • 検索エンジンID（cx）をコピーする

Related MCP server: MCP Server for Google Search

発達

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

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

特徴

検索ツール

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

• ウェブ全体または特定のサイトを検索する

• 結果の制御数（1～10）

• タイトル、リンク、スニペットで構造化された結果を取得します

ウェブページリーダーツール

任意の Web ページからコンテンツを抽出します。

• ウェブページのコンテンツを取得して解析する

• ページのタイトルと本文を抽出

• スクリプトとスタイルを削除してコンテンツを整理する

• タイトル、テキスト、URLを含む構造化データを返す

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Google カスタム検索サーバーを自動的にインストールするには:

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

Claude Desktop で使用するには、Google API 認証情報を使用してサーバー設定を追加します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json 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"
      }
    }
  }
}

使用法

検索ツール

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

ウェブページリーダーツール

{
  "name": "read_webpage",
  "arguments": {
    "url": "https://example.com"
  }
}

ウェブページリーダーからの応答例:

{
  "title": "Example Domain",
  "text": "Extracted and cleaned webpage content...",
  "url": "https://example.com"
}

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。