バージョン2.0が登場!!
ニュース - 新しい「KiCAD MCP サーバー」が登場しました。この「Google Search MCP サーバー」と組み合わせると強力なコンビになります。
https://github.com/mixelpixx/KiCAD-MCP-Server
Google 検索 MCP サーバー
Google検索機能とウェブページコンテンツ分析ツールを提供するMCP（Model Context Protocol）サーバー。このサーバーにより、AIモデルはGoogle検索を実行し、ウェブページコンテンツをプログラムで分析できるようになります。
特徴
- Googleカスタム検索の統合
- 高度な検索機能（フィルター、並べ替え、ページ区切り、分類）
- 複数の形式（マークダウン、HTML、プレーンテキスト）でのウェブページコンテンツ分析
- バッチウェブページ分析
- 結果の分類と分類
- コンテンツの要約
- 最適化された、人間が読める応答
- MCP準拠インターフェース
前提条件
- Node.js (v16 以上)
- Google Cloud Platform アカウント
- カスタム検索エンジンID
- Google APIキー
インストール
- リポジトリをクローンする
- Node.js の依存関係をインストールします。
- TypeScript コードをビルドします。
構成
- Google API 認証情報の環境変数を設定します。
これらをシステム環境変数として設定するか、MCP 設定ファイルで構成することができます。
必要な環境変数:
GOOGLE_API_KEY : Google APIキーGOOGLE_SEARCH_ENGINE_ID : カスタム検索エンジンID
- サーバー構成を MCP 設定ファイル (通常は
%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonにあります) に追加します。
{
"mcpServers": {
"google-search": {
"autoApprove": [
"google_search",
"extract_webpage_content",
"extract_multiple_webpages"
],
"disabled": false,
"timeout": 60,
"command": "node",
"args": [
"/path/to/google-search-mcp-server/dist/google-search.js"
],
"env": {
"GOOGLE_API_KEY": "your-google-api-key",
"GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
},
"transportType": "stdio"
}
}
}
ランニング
MCP サーバーを起動します。
利用可能なツール
1. google_search
Googleで検索し、ウェブから関連する結果を返します。このツールは、Googleの検索エンジンを使用して、特定のトピックに関するウェブページ、記事、情報を検索します。
{
"name": "google_search",
"arguments": {
"query": "your search query",
"num_results": 5, // optional, default: 5
"site": "example.com", // optional, limit results to specific website
"language": "en", // optional, filter by language (ISO 639-1 code)
"dateRestrict": "m6", // optional, filter by date (e.g., "m6" for last 6 months)
"exactTerms": "exact phrase", // optional, search for exact phrase
"resultType": "news", // optional, specify type (news, images, videos)
"page": 2, // optional, page number for pagination (starts at 1)
"resultsPerPage": 10, // optional, results per page (max: 10)
"sort": "date" // optional, sort by "date" or "relevance" (default)
}
}
回答には以下が含まれます:
- タイトル、リンク、スニペットを読みやすい形式で表示した検索結果
- ページネーション情報（現在のページ、合計結果など）
- 結果のカテゴリ（自動検出）
- ページネーションのナビゲーションヒント
2. ウェブページのコンテンツを抽出する
ウェブページからコンテンツを抽出・分析し、読みやすいテキストに変換します。このツールは、広告、ナビゲーション要素、その他の不要な要素を削除しながら、メインコンテンツのみを取得します。
{
"name": "extract_webpage_content",
"arguments": {
"url": "https://example.com",
"format": "markdown" // optional, format options: "markdown" (default), "html", or "text"
}
}
回答には以下が含まれます:
- ウェブページのタイトルと説明
- コンテンツ統計（単語数、文字数）
- コンテンツの概要
- コンテンツのプレビュー（最初の500文字）
3. 複数のウェブページを抽出する
複数のウェブページからコンテンツを抽出し、単一のリクエストで分析します。異なるソース間で情報を比較したり、特定のトピックに関する包括的な情報を収集したりするのに最適です。
{
"name": "extract_multiple_webpages",
"arguments": {
"urls": [
"https://example1.com",
"https://example2.com"
],
"format": "html" // optional, format options: "markdown" (default), "html", or "text"
}
}
回答には以下が含まれます:
- 各ウェブページのタイトルと説明
- 各ウェブページのコンテンツ統計
- 各ウェブページのコンテンツ概要
- 各ウェブページのコンテンツプレビュー（最初の150文字）
Google API認証情報の取得
- Google Cloud Consoleにアクセスします
- 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
- カスタム検索APIを有効にする
- API 認証情報 (API キー) を作成する
- カスタム検索エンジンのページに移動します
- 新しい検索エンジンを作成し、��索エンジンIDを取得します
- これらの資格情報をMCP設定ファイルに追加するか、環境変数として設定します。
エラー処理
サーバーは、次の詳細なエラー メッセージを提供します。
- API 認証情報が見つからないか無効です
- 失敗した検索リクエスト
- 無効なウェブページのURL
- ネットワーク接続の問題
建築
このサーバーはTypeScriptで構築されており、MCP SDKを使用して、AIモデルがGoogle検索やウェブページコンテンツ分析ツールと連携するための標準化されたインターフェースを提供します。このサーバーは、主に以下の2つのサービスで構成されています。
- GoogleSearchService : 検索機能のための Google API のやり取りを処理します
- ContentExtractor : ウェブページのコンテンツ分析と抽出を管理します
サーバーはキャッシュ メカニズムを使用してパフォーマンスを向上させ、API 呼び出しを削減します。
ビルド版の配布
このツールのソース コードではなくビルド バージョンのみを配布する場合は、次の手順に従ってください。
- TypeScript コードをビルドします。
- 必要なファイルのみを含む配布パッケージを作成します。
# Create a distribution directory
mkdir -p dist-package
# Copy the compiled JavaScript files
cp -r dist dist-package/
# Copy package files (without dev dependencies)
cp package.json dist-package/
cp README.md dist-package/
# Create a simplified package.json for distribution
node -e "const pkg = require('./package.json'); delete pkg.devDependencies; delete pkg.scripts.build; delete pkg.scripts.dev; pkg.scripts.start = 'node dist/google-search.js'; require('fs').writeFileSync('dist-package/package.json', JSON.stringify(pkg, null, 2));"
- ユーザーはビルドされたバージョンをインストールして実行できます。
# Install production dependencies only
npm install --production
# Start the server
npm start
このアプローチにより、TypeScriptのソースコードを公開することなく、コンパイルされたJavaScriptファイルを配布できます。ただし、ユーザーは以下の手順を実行する必要があります。
- Google API 認証情報を環境変数として設定する
- サーバー構成をMCP設定ファイルに追加する
- 本番環境の依存関係をインストールする
配布版の package.json には、本番環境の依存関係と簡略化されたスクリプト セットのみが含まれることに注意してください。
ライセンス
マサチューセッツ工科大学