Google Custom Search Engine MCP Server

Google Custom Search Engine MCP Server

site icon
2025.01.27 15
Python搜索服务AI 工具集成搜索工具
mcp-google-cse 是一个基于 Model Context Protocol (MCP) 的服务器,提供自定义搜索引擎(CSE)的搜索能力。它允许大型语言模型(LLMs)通过常规的 Google 搜索词进行搜索,并返回搜索结果。该服务器仅返回搜索结果本身,而不返回内容,因此需要与其他服务器(如 mcp-server-fetch)结合使用以提取内容。免费配额为每天 100 次搜索(1 次工具调用等于 1 次搜索),适用于需要集成搜索功能的 AI 应用场景。
View on GitHub

Overview

基本能力

产品定位

mcp-google-cse 是一个为 AI 模型提供自定义搜索引擎功能的 MCP 服务器,旨在扩展 AI 模型的搜索能力。

核心功能

  • 提供自定义搜索引擎(CSE)的搜索能力
  • 返回搜索结果的标题、链接和摘要
  • 支持多种可配置参数(如国家/地区、语言、结果数量等)

适用场景

  • AI 模型需要集成搜索功能的场景
  • 需要将搜索结果与其他工具链结合使用的场景
  • 开发需要搜索能力的 AI 应用

工具列表

  • google_search:使用搜索词搜索自定义搜索引擎,返回包含每个结果的标题、链接和摘要的列表
  • 参数:search_term(字符串,必需):要搜索的术语,等同于通常 Google 搜索中的 q 查询参数

常见问题解答

  • 免费配额为每天 100 次搜索
  • 需要与其他服务器结合使用以提取内容
  • 需要配置 API_KEY 和 ENGINE_ID 环境变量

使用教程

使用依赖

  • 需要 Python 环境
  • 需要 Google Cloud 项目和自定义搜索引擎 API 密钥

安装教程

使用 uv(推荐)

uvx mcp-google-cse

使用 PIP

pip install mcp-google-cse

安装后运行:

python -m mcp-google-cse

通过 Smithery 安装

npx -y @smithery/cli install @Richard-Weiss/mcp-google-cse --client claude

调试方式

配置 Claude 应用

添加到 claude_desktop_config.json:

使用 uvx
"mcp-google-cse": {
    "command": "uvx",
    "args": ["mcp-google-cse"],
    "env": {
        "API_KEY": "",
        "ENGINE_ID": ""
    }
}
使用 pip 安装
"mcp-google-cse": {
    "command": "python",
    "args": ["-m", "mcp-google-cse"],
    "env": {
        "API_KEY": "",
        "ENGINE_ID": ""
    }
}
本地运行
"mcp-google-cse": {
    "command": "uv",
    "args": [
        "--directory",
        "{{Path to the cloned repo",
        "run",
        "mcp-google-cse"
    ],
    "env": {
        "API_KEY": "",
        "ENGINE_ID": ""
    }
}

许可证

该项目遵循 Unlicense 开源许可条款,请参阅 Unlicense 了解完整条款。