跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP（Model Context Protocol） 是由 Anthropic 推出的模型上下文协议，允许 AI 模型（如 Claude、GPT 等）通过标准化接口调用外部工具。通过 AceData Cloud 提供的 SERP MCP Server，你可以在 Claude Desktop、VS Code、Cursor 等 AI 客户端中直接进行 Google 搜索，获取网页、图片、新闻、视频、地点等搜索结果。

​
功能概览

SERP MCP Server 提供以下核心功能：
  • 网页搜索 — 搜索 Google 网页结果
  • 图片搜索 — 搜索 Google 图片
  • 新闻搜索 — 搜索 Google 新闻
  • 视频搜索 — 搜索 Google 视频
  • 地点搜索 — 搜索 Google 地点信息
  • 地图搜索 — 搜索 Google 地图
  • 多语言多地区 — 支持自定义国家和语言参数
  • 时间范围筛选 — 按天、周、月、年筛选结果

​
前置准备

使用前，你需要获取 AceData Cloud API Token：
  1. 注册或登录 AceData Cloud 平台
  2. 前往 Google SERP API 页面
  3. 点击「Acquire」获取 API Token（首次申请赠送免费额度）

​
安装配置

​
方式一：pip 安装（推荐）

pip install mcp-serp

​
方式二：源码安装

git clone https://github.com/AceDataCloud/MCPSerp.git
cd MCPSerp
pip install -e .
安装完成后，即可使用 mcp-serp 命令启动服务。

​
在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
添加以下配置： 
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}
如果使用 uvx（无需提前安装包）： 
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}
保存配置后重启 Claude Desktop，即可在对话中使用 Google 搜索相关工具。

​
在 VS Code / Cursor 中使用

在项目根目录创建 .vscode/mcp.json： 
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}
或者使用 uvx： 
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}

​
可用工具列表

工具名说明
serp_google_searchGoogle 网页搜索
serp_google_imagesGoogle 图片搜索
serp_google_newsGoogle 新闻搜索
serp_google_videosGoogle 视频搜索
serp_google_placesGoogle 地点搜索
serp_google_mapsGoogle 地图搜索

​
使用示例

配置完成后，你可以在 AI 客户端中直接用自然语言调用这些功能，例如：
  • 「帮我搜索一下最新的 AI 论文」
  • 「搜索北京好吃的火锅店」
  • 「查找关于 Python 异步编程的图片」
  • 「搜索今天的科技新闻」
  • 「在地图上查找附近的咖啡厅」

​
更多信息