G
Google Search MCP Server（谷歌搜索模型上下文协议服务器）
@moritalous/google-search-mcp-server
0 Stars
553 次浏览
moritalous
更新于 2026-08-23
一个模型上下文协议服务器，它使人工智能助手能够使用Google搜索API进行网络搜索，并以JSON格式返回多达20个搜索结果。
该服务暂未提供标准配置，请参考 README 手动接入
服务介绍
Google Search MCP 服务器
该项目是一个提供 Google 搜索 API 功能的 Model Context Protocol (MCP) 服务器，用于 AI 助手。
概述
Google Search MCP 服务器是一种工具，它使 AI 助手能够使用 Google 搜索 API 执行网络搜索。通过 Gradio 和 MCP 提供了 AI 助手与 Google 搜索 API 之间的接口。
功能
- 使用 Google 搜索 API 进行网络搜索
- 以 JSON 格式返回搜索结果
- 获取最多 20 条搜索结果
先决条件
- Python 3.12 或更高版本
- Google 自定义搜索引擎 ID
- Google API 密钥
安装
- 克隆仓库：
bash
git clone https://github.com/yourusername/google-search-mcp-server.git
cd google-search-mcp-server
- 安装依赖项：
bash
pip install -e .
- 设置环境变量：
将 .env.sample 文件复制为 .env 并添加所需的 API 密钥：
bash
cp .env.sample .env
编辑 .env 文件并设置以下值：
GOOGLE_CSE_ID=您的Google自定义搜索引擎ID
GOOGLE_API_KEY=您的GoogleAPI密钥
使用方法
启动服务器：
bash
python app.py
这将启动 Gradio 界面，并作为 MCP 服务器运行。
与 MCP 的集成
该服务器使用 Model Context Protocol (MCP) 与 AI 助手集成。AI 助手可以通过此服务器访问 Google 搜索功能。
API 参考
perform_web_search
python
perform_web_search(query: str, num_results: int = 10)
参数:
query(str): 搜索查询（最多 400 个字符，50 个单词）num_results(int): 结果数量（1 到 20，默认 10）
返回值:
str: JSON 格式的搜索结果
