Google Programmable Search Engine (PSE) MCP Server

Google Programmable Search Engine (PSE) MCP サーバー

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

インストール手順

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

VS Code Copilot の設定

コマンドパレットを開き、［Preferences: Open Settings (JSON)］を選択して、次の内容を追加します。

settings.json

{
  // Other settings...
  "mcp": {
    "servers": {
      "google-pse-mcp": {
        "command": "npx",
        "args": [
          "-y",
          "google-pse-mcp",
          "https://www.googleapis.com/customsearch",
          "<api_key>",
          "<cx>",
          "<siteRestricted>" // optional: true/false, defaults to true
        ]
      }
    }
  }
}

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>",
        "<siteRestricted>" // optional flag, true/false, defaults to true
      ],
      "transportType": "stdio"
    }
  }
}

重要な注意事項

上記の設定で、<api_key> と <cx> をご自身の認証情報に置き換えてください。 また、使用する Google Custom Search エンドポイントを制御するため、最後の引数としてオプションの <siteRestricted> フラグ（true または false）を指定できます。省略した場合、デフォルトは true です。

利用可能なツール

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

1. search：Google Programmable Search Engine でウェブを検索します

   • パラメーター：
     • q（文字列、必須）：検索クエリ
     • page（整数、任意）：ページ番号
     • size（整数、任意）：1 ページあたりの検索結果数（1～10）
     • sort（文字列、任意）：並べ替え式（date のみサポート）
     • safe（ブール値、任意）：セーフサーチのフィルタリングを有効にします
     • lr（文字列、任意）：検索対象を特定の言語に絞り込みます（例：lang_en）
     • siteRestricted（ブール値、任意）：サイト制限 API エンドポイントを使用します。CLI フラグで上書きされない限り、デフォルトは true です

使用例

# Search for "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 サーバー
• Google Programmable Search Engine の概要