Google 搜索 MCP 服务器

该项目是一个 Model Context Protocol (MCP) 服务器，用于向 AI 助手提供 Google 搜索 API 功能。

概述

Google 搜索 MCP 服务器是一个工具，它允许 AI 助手通过使用 Google 搜索 API 来执行网络搜索。该服务器使用 Gradio 和 MCP 提供了 AI 助手与 Google 搜索 API 之间的接口。

功能

• 使用 Google 搜索 API 进行网络搜索
• 返回 JSON 格式的搜索结果
• 获取最多 20 条搜索结果

必要条件

• Python 3.12 或更高版本
• Google 自定义搜索引擎 ID
• Google API 密钥

安装

1. 克隆仓库：

git clone https://github.com/yourusername/google-search-mcp-server.git
cd google-search-mcp-server

2. 安装依赖项：

pip install -e .

3. 设置环境变量：

复制 .env.sample 文件到 .env 并添加所需的 API 密钥：

cp .env.sample .env

编辑 .env 文件并设置以下值：

GOOGLE_CSE_ID=您的Google自定义搜索引擎ID
GOOGLE_API_KEY=您的Google API密钥

使用方法

启动服务器：

python app.py

这将启动 Gradio 接口，并作为 MCP 服务器运行。

MCP 集成

此服务器通过 Model Context Protocol (MCP) 与 AI 助手集成。AI 助手可以通过此服务器访问 Google 搜索功能。

API 参考

perform_web_search

perform_web_search(query: str, num_results: int = 10)

参数:

• query (str): 搜索查询（最大 400 字符，50 个单词）
• num_results (int): 结果数量（1 到 20，默认 10）

返回值:

• str: JSON 格式的搜索结果