Google 풀그릴 검색 엔진 (PSE) API에 대한 Model Context Protocol (MCP) 서버. 이 서버는 VSCode, Copilot 및 Claude Desktop과 같은 MCP 호환 클라이언트에 액세스 할 수 있도록 Google Custom Search Engine으로 웹을 검색하기위한 도구를 노출합니다.

설치 단계

이 저장소를 수동으로 복제하거나 설치 명령을 직접 실행할 필요가 없습니다. 해당 MCP 클라이언트에 아래의 구성을 간단히 추가하면 클라이언트가 자동으로 설치하고 서버를 실행할 수 있습니다.

VS 코드 Copilot 윤곽

명령 Palette → 설정 열기: 설정 열기 (JSON), 다음 추가:

settings.json] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0] [T0] [T0]] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0]] settings.json] settings.json]]] settings.json]]]]]] [[settings.json]]]]]]] [[[[[[settings.json]]]]]]]]]]]]]] [[[[[[[settings.json]]]]]]]]]]]]]]]]]] [[[[[[[[[[[[[[[[[[[[[[

Cline MCP 윤곽 보기

Cline을 사용하는 경우, cline_mcp_settings.json]에 다음을 추가하십시오 (보통 VSCode 글로벌 스토리지 또는 Cline 구성 디렉토리에서 발견):

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

중요 노트

]과 ]를 위 설정에서 자격으로 바꾸는 것을 잊지 마세요.

Google Programmable Search Engine (PSE) MCP Server

A Model Context Protocol (MCP) server for the Google Programmable Search Engine (PSE) API. This server exposes tools for searching the web with Google Custom Search engine, making them accessible to MCP-compatible clients such as VSCode, Copilot, and Claude Desktop.

Installation Steps

You do NOT need to clone this repository manually or run any installation commands yourself. Simply add the configuration below to your respective MCP client—your client will automatically install and launch the server as needed.

VS Code Copilot Configuration

Open Command Palette → Preferences: Open Settings (JSON), then add:

settings.json

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

Cline MCP Configuration Example

If you are using Cline, add the following to your cline_mcp_settings.json (usually found in your VSCode global storage or Cline config directory):

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

Important Notes

Don’t forget to replace and with your credentials in the configuration above. You can also provide an optional `` flag (true or false) as the last argument to control which Google Custom Search endpoint is used. If omitted, it defaults to true.

Available Tools

This MCP server provides the following tool:

1. search: Search the web with Google Programmable Search Engine

   • Parameters:
     • q (string, required): Search query
     • page (integer, optional): Page number
     • size (integer, optional): Number of search results to return per page (1-10)
     • sort (string, optional): Sort expression (only ‘date’ is supported)
     • safe (boolean, optional): Enable safe search filtering
     • lr (string, optional): Restrict search to a particular language (e.g., lang_en)