Google Programmable Search Engine (PSE) MCP Server

Name: Google Programmable Search Engine (PSE) MCP Server
Author: rendyfebry

本地服务

github.com/rendyfebry搜索与检索1256 周前更新

代码仓库

关于 Google Programmable Search Engine (PSE) MCP Server

Google Programmable Search Engine (PSE) MCP Server 通过网页搜索工具，让兼容 MCP 的客户端使用 Google Custom Search。它支持查询、结果数量、日期排序、安全搜索、语言和站点限制等选项。

主要功能

01使用 Google PSE 搜索网页
02设置结果页码和数量
03按日期排序结果
04应用安全搜索和语言筛选
05将搜索限制在指定站点

适用场景

01通过 MCP 客户端搜索网页
02将结果限定为指定语言
03在指定站点内搜索

MCP 相关

向 MCP 客户端提供用于查询 Google Programmable Search Engine 的 `search` 工具。该工具支持分页、结果数量、排序、筛选和站点限制选项。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "google-pse": {
      "command": "npx",
      "args": [
        "-y",
        "google-pse-mcp"
      ]
    }
  }
}

启动命令npx -y google-pse-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmgoogle-pse-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
q	string	是	搜索查询
page	integer	否	页码
size	integer	否	每页返回的搜索结果数。有效值为 1 到 10（含）的整数。
sort	string	否	排序表达式（例如，'date'）。API 仅支持 'date'。
safe	boolean	否	启用安全搜索过滤。默认值：false。
lr	string	否	将搜索范围限制为特定语言的文档（例如，lang_en、lang_ja）
siteRestricted	boolean	否	如果为 true，则使用 Site Restricted API 端点（/v1/siterestrict）。如果为 false，则使用标准 API 端点（/v1）。默认值：true。

详细介绍

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 配置

打开命令面板 → 首选项：打开设置 (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> 替换为你的凭据。你还可以提供可选的 <siteRestricted> 标志（true 或 false），作为最后一个参数，用于控制所使用的 Google Custom Search 端点。如果省略，则默认为 true。

可用工具

此 MCP 服务提供以下工具：

search：使用 Google Programmable Search Engine 搜索网页
- 参数：
  - q（字符串，必填）：搜索查询
  - page（整数，可选）：页码
  - size（整数，可选）：每页返回的搜索结果数量（1-10）
  - sort（字符串，可选）：排序表达式（仅支持 'date'）
  - safe（布尔值，可选）：启用安全搜索过滤
  - lr（字符串，可选）：将搜索限定为特定语言（例如 lang_en）
  - siteRestricted（布尔值，可选）：使用 Site Restricted 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
    }
)