Google Search MCP
Google 検索 MCP
Google検索用のモデルコンテキストプロトコルサーバー。Playwrightベースのモデルコンテキストプロトコル(MCP)ツールは、検索エンジンのボット対策メカニズムを回避し、Google検索を実行して結果を抽出することで、ClaudeやCursorなどのAIアシスタントにリアルタイム検索機能を提供します。
特徴
アンチボットバイパス: ブラウザのフィンガープリントスプーフィングと実際のユーザー行動シミュレーションを使用して検出を回避します
自動 CAPTCHA 処理: CAPTCHA に遭遇すると、ヘッダーモードに切り替えて、ユーザーが検証を完了できるようにします。
状態の永続性: ブラウザのセッション状態を保存して、繰り返し検証する必要性を軽減します。
適応性: 複数のセレクタの組み合わせを使用して、Google 検索ページの変更に適応します。
MCP 統合: AI アシスタントとの統合を容易にするモデル コンテキスト プロトコルを実装します。
多言語サポート: さまざまな言語や地域での検索結果をサポートします
Related MCP server: Playread
カーソルの使用
インストール - グローバル
npx を使用して MCP サーバーを実行します。
npx -y @mcp-server/google-search-mcp@latestカーソルIDEで
Cursor Settings>MCPへ移動します。+ Add New MCP Serverクリックフォームに記入してください:
名前:
google-search(または任意の名前)タイプ:
commandコマンド:
npx -y @mcp-server/google-search-mcp@latest
インストール - プロジェクト固有
プロジェクトに.cursor/mcp.jsonファイルを追加します。
{
"mcpServers": {
"google-search": {
"command": "npx",
"args": [
"-y",
"@mcp-server/google-search-mcp@latest"
]
}
}
}発達
yarn installプロジェクトを構築する
yarn build使用法
MCP サーバーとして実行
yarn startMCP Inspectorと併用
サーバーをデバッグするには、 MCP Inspectorを使用できます。
# First build the project
yarn build
# Start the MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.jsパラメータ
検索ツールは次のパラメータを受け入れます。
query(必須): 検索クエリ文字列limit(オプション): 返される検索結果の数。デフォルトは 10 です。timeout(オプション):検索操作のタイムアウト(ミリ秒単位)、デフォルトは60000language(オプション): 検索結果の言語 (例: zh-CN、en-US、デフォルト: zh-CN)region(オプション): 検索結果の地域 (例: cn、com、co.jp、デフォルトは cn)
仕組み
このツールはPlaywrightを使ってChromiumブラウザを制御し、Google検索を実行する。
ブラウザのフィンガープリントの偽装と実際のユーザー行動のシミュレーションによりボット検出を回避します。
CAPTCHA認証に遭遇すると、自動的にユーザー完了のための見出しモードに切り替わります。
検索結果を抽出し、構造化された形式で返します
ブラウザの状態を保存し、その後の検索で再利用します。
詳細設定
ブラウザ状態ファイル
デフォルトでは、ブラウザの状態はユーザーのホームディレクトリにある.google-search-browser-state.jsonファイルに保存されます。このパスはパラメータで変更できます。
言語と地域の設定
パラメータを使用して、検索結果の言語と地域を指定できます。
// English (US) search results
"language": "en-US", "region": "com"
// Japanese search results
"language": "ja-JP", "region": "co.jp"
// Chinese (Simplified) search results
"language": "zh-CN", "region": "cn"注記
初めて使用する場合、CAPTCHA認証に遭遇すると、システムは自動的にヘッドモードに切り替わり、認証を完了します。
検証後、システムは状態ファイルを保存し、その後の検索をスムーズにします。
過度に頻繁な検索リクエストは、Google のレート制限メカニズムをトリガーする可能性があります。
このツールは学習と研究の目的のみに使用してください。Googleの利用規約を遵守してください。
ライセンス
マサチューセッツ工科大学
免責事項
このツールは学習および研究目的のみにご使用ください。このツールを使用してGoogleまたはその他の検索エンジンにアクセスする場合は、関連する利用規約および法的規制を遵守してください。このツールの使用に起因するいかなる問題についても、作者は一切責任を負いません。
Available Tools
1 toolsearchD
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 搜索查询字符串 | |
| limit | No | 返回的搜索结果数量,默认为10 | |
| timeout | No | 搜索操作的超时时间(毫秒),默认为60000 | |
| language | No | 搜索结果的语言,例如 zh-CN, en-US 等,默认为 zh-CN | |
| region | No | 搜索结果的地区,例如 cn, com, co.jp 等,默认为 cn |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Tool has no description.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Tool has no description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool has no description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Tool has no description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Tool has no description.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Tool has no description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- First observed
search
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'search' has a distinct and clear purpose by default.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'search' follows a simple, clear verb pattern.
One tool is too few for a server named 'Google Search MCP', which suggests a domain that might benefit from more functionality (e.g., advanced search options, filtering, or result management). A single tool feels thin and under-scoped for such a purpose.
The server is severely incomplete for a search domain. With only a basic 'search' tool and no description, it lacks obvious features like pagination, filtering by date or type, or handling search results, which are essential for effective search operations.
Maintenance
Related MCP Connectors
Search Google straight from your AI agent. Web results, images, videos, news, products, scholarly ar
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Google search, news, maps, scholar and public webpages for AI agents, with Markdown results.
Real-time web search for AI agents: ranked results, source URLs, and optional AI answers.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform real-time Google searches with anti-bot protection. Bypasses search engine restrictions using advanced browser automation to extract search results locally without requiring paid API services.6MIT
- AlicenseNot gradedqualityFmaintenanceEnables Google search automation and web content extraction using Playwright. Performs Google searches and fetches main content from web pages, returning structured results in JSON format.23 npmMIT
- AlicenseBqualityDmaintenanceExposes Playwright-powered automation tools to AI assistants for navigating web pages, interacting with elements, and extracting structured data. It features specialized scrapers for Indeed and Google Search, along with stealth mode to bypass bot detection.30ISC
- AlicenseNot gradedqualityFmaintenanceProvides real-time Google search capabilities to AI assistants like Claude, bypassing anti-scraping mechanisms.20 npm622MIT