SerpMCP · Google 搜索结构化结果 MCP 服务器

技能简介

SerpMCP（PyPI 包名 mcp-serp）是一款把 Google 搜索结果结构化输出的 MCP 服务器。通过 AceDataCloud 的 SERP API 包装，Agent 可以直接调用 web_search / image_search / news_search / video_search / places_search 等工具，获得带 URL、标题、摘要、缩略图的清洗过的 JSON，免去自己爬 Google 的反爬烦恼。

它是 AceDataCloud 的 MCP 系列之一（与 SeedreamMCP 同源），已经为 Claude / Cursor / VS Code 等客户端做了开箱即用的 MCP 客户端配置，文档齐全、变更日志透明。

核心能力

• Web 搜索：常规 Google 网页搜索，返回结构化的 URL + 标题 + 摘要列表
• 图片搜索：获取带 URL 与缩略图的图片搜索结果
• 新闻搜索：针对任意主题的 Google News 实时结果
• 视频搜索：覆盖 YouTube 等视频源的搜索结果
• 地点搜索：Places / 本地商户结果（名称、地址、评分等）
• MCP 原生支持：通过 FastMCP 暴露，Claude / Cursor / Cline 等即插即用
• 结构化输出：所有结果统一 JSON schema，方便 Agent 解析与下游处理
• 多语言支持：覆盖 Google 全球索引，支持多语言查询

安装配置

1. PyPI 安装：

   pip install mcp-serp
   # 或用 uv
   uv pip install mcp-serp

2. 注册 AceDataCloud 账户：访问 https://platform.acedata.cloud 注册并获取 SERP API Key

3. 配置环境变量：

   export ACEDATACLOUD_API_KEY="your-api-key"

4. MCP 客户端配置（Claude Desktop / Cursor / VS Code）：

   {
   "mcpServers": {
    "mcp-serp": {
      "command": "mcp-serp",
      "args": ["--transport", "stdio"],
      "env": {
        "ACEDATACLOUD_API_KEY": "your-api-key"
      }
    }
   }
   }

使用步骤

1. 安装并配置：按"安装配置"完成 pip install + API Key 配置
2. 启动 MCP 服务器：mcp-serp --transport stdio 等待客户端连接
3. 在 Claude / Cursor 中调用 web_search：例如"搜索 'aiproducthub launch 今日榜'"
4. 获取结构化 JSON：Agent 收到带 URL、title、snippet 的列表
5. 深入挖掘：可继续调用 image_search / news_search / video_search / places_search
6. 结合下游工具：把搜索结果喂给 Claude 写摘要，或喂给 Notion / 数据库
7. 配额与计费：按 AceDataCloud 平台计费规则消耗 SERP API 配额，可在 Dashboard 监控

适用场景

• AI 编程助手联网搜索：让 Claude Code / Cursor 在调试时直接查最新文档
• 新闻 / 舆情监控：让 Agent 周期性跑 news_search，汇总形成日报
• 市场调研：组合 web_search + places_search，分析本地商户或竞争对手
• 学术研究：把搜索结果喂给 LLM 做文献综述 / 二次筛选
• 内容生产：让 Agent 自动搜图（image_search）+ 写文章 + 配图
• AI 搜索 Agent：作为 RAG 的"实时搜索"层，弥补 LLM 知识截止

适用人群

• AI Agent 应用开发者（需要给 Agent 装"实时搜索"）
• AI 编程工具作者（Cursor / Cline 等需要联网搜索能力）
• 媒体 / 营销 / SEO 从业者（自动化新闻 / 舆情监控）
• 学术 / 研究人员（让 LLM 辅助文献调研）
• 创业团队（用最少代码接入 Google 搜索）
• 数据分析师（用结构化结果做下游分析）

工作原理

SerpMCP 启动后以 stdio / HTTP 暴露 MCP 工具集，每个工具对应 AceDataCloud SERP API 的一种查询类型（web / image / news / video / places）。客户端（Claude 等）调用工具时，服务器把请求转译为 AceDataCloud 平台调用、附带 API Key 鉴权，返回 Google 原始搜索结果后清洗为统一 JSON schema，再以 MCP 响应回传给 Agent。整个链路只需一次 HTTPS 调用、无需任何爬虫基础设施。

官方链接

• PyPI：https://pypi.org/project/mcp-serp/
• GitHub：https://github.com/AceDataCloud/SerpMCP
• 文档：https://platform.acedata.cloud/documents/serp-mcp
• SERP API 文档：https://platform.acedata.cloud/documents/serp-google
• Changelog：https://github.com/AceDataCloud/SerpMCP/blob/main/CHANGELOG.md