Google Pse MCP

🚀 Google Programmable Search Engine (PSE) MCP Server

Google Programmable Search Engine (PSE) API用のModel Context Protocol (MCP)サーバーです。このサーバーは、Google Custom Searchエンジンを使用してウェブを検索するツールを公開し、VSCode、Copilot、Claude DesktopなどのMCP互換クライアントからアクセスできるようにします。

🚀 クイックスタート

このサーバーを使用することで、MCP互換クライアントを通じてGoogle Custom Searchエンジンを利用したウェブ検索が可能になります。

📦 インストール

このリポジトリを手動でクローンしたり、インストールコマンドを実行する必要はありません。以下の設定をそれぞれのMCPクライアントに追加するだけで、クライアントが必要に応じて自動的にサーバーをインストールして起動します。

VS Code Copilot設定

コマンドパレットを開き → 設定: 設定 (JSON) を開き、以下を追加します。

settings.json

{
  // その他の設定...
  "mcp": {
    "servers": {
      "google-pse-mcp": {
        "command": "npx",
        "args": [
          "-y",
          "google-pse-mcp",
          "https://www.googleapis.com/customsearch",
          "<api_key>",
          "<cx>"
        ]
      }
    }
  }
}

Cline MCP設定例

Clineを使用している場合は、以下をcline_mcp_settings.json（通常はVSCodeのグローバルストレージまたはClineの設定ディレクトリにあります）に追加します。

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "google-pse-mcp": {
      "disabled": false,
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "google-pse-mcp",
        "https://www.googleapis.com/customsearch",
        "<api_key>",
        "<cx>"
      ],
      "transportType": "stdio"
    }
  }
}

⚠️ 重要提示

上記の設定で<api_key>と<cx>をあなたの認証情報に置き換えるのを忘れないでください。

✨ 主な機能

このMCPサーバーは以下のツールを提供します。

1. search: Google Programmable Search Engineを使用してウェブを検索します。
   • パラメータ:
     • q (文字列、必須): 検索クエリ
     • page (整数、オプション): ページ番号
     • size (整数、オプション): 1ページあたりに返す検索結果の数 (1 - 10)
     • sort (文字列、オプション): ソート式 (「date」のみサポート)
     • safe (ブール値、オプション): セーフサーチフィルターを有効にする
     • lr (文字列、オプション): 特定の言語での検索を制限する (例: lang_en)
     • siteRestricted (ブール値、オプション): サイト制限APIエンドポイントを使用する

💻 使用例

基本的な使用法

# "artificial intelligence"を検索する
result = await use_mcp_tool(
    server_name="google-pse-mcp",
    tool_name="search",
    arguments={
        "q": "artificial intelligence",
        "size": 5,
        "safe": True
    }
)

📚 ドキュメント

• Model Context Protocol Servers
• Google Programmable Search Engine Intro