Google Pse MCP

🚀 谷歌可編程搜索引擎（PSE）MCP服務器

這是一個用於谷歌可編程搜索引擎（PSE）API的模型上下文協議（MCP）服務器。該服務器提供了使用谷歌自定義搜索引擎進行網絡搜索的工具，這些工具可被與MCP兼容的客戶端（如VSCode、Copilot和Claude Desktop）訪問。

🚀 快速開始

你無需手動克隆此倉庫或自行運行任何安裝命令。只需將以下配置添加到相應的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：使用谷歌可編程搜索引擎進行網絡搜索
   • 參數：
     • q（字符串，必需）：搜索查詢
     • page（整數，可選）：頁碼
     • size（整數，可選）：每頁返回的搜索結果數量（1 - 10）
     • sort（字符串，可選）：排序表達式（僅支持 'date'）
     • safe（布爾值，可選）：啟用安全搜索過濾
     • lr（字符串，可選）：將搜索限制在特定語言（例如，lang_en）
     • siteRestricted（布爾值，可選）：使用站點限制API端點

💻 使用示例

基礎用法

# 搜索 "人工智能"
result = await use_mcp_tool(
    server_name="google-pse-mcp",
    tool_name="search",
    arguments={
        "q": "artificial intelligence",
        "size": 5,
        "safe": True
    }
)

📚 詳細文檔

• 模型上下文協議服務器
• 谷歌可編程搜索引擎簡介