Serper

Serper MCP 服务

一个与 Serper API 集成的 MCP 服务实现，可通过 Google 搜索结果提供全面的网页、新闻、图片和视频搜索功能。此外，它还包含使用 FireCrawl 从搜索结果中提取内容的网页抓取功能，以及基于位置的服务。

功能

• 网页搜索：常规查询、知识图谱、其他人也在问等
• 新闻搜索：文章、新闻稿和包含来源信息的时效性内容
• 图片搜索：照片、图表、徽标和其他视觉内容
• 视频搜索：来自 YouTube 和其他平台的视频
• 地图搜索：地点、商家和兴趣点的详细信息
• 评价搜索：商家和地点的详细用户评价和评分
• 网页抓取：从搜索结果中的任意网页提取并整理内容
• 位置服务：获取当前 GPS 坐标，以支持基于位置的搜索
• 基于位置的结果：支持按国家和位置进行搜索
• 丰富结果格式化：来自知识图谱和答案框的结构化数据

工具

• serper_web_search

  • 根据地理位置上下文执行网页搜索
  • 输入：
    • query（字符串）：搜索词
    • location（字符串，可选）：地理位置上下文（例如，“United States”“India”）
    • gl（字符串，可选）：Google 国家/地区代码（例如，“us”“in”“uk”）
    • num（数字，可选）：结果数量（最多 20 条）

• serper_news_search

  • 搜索新闻文章和新闻稿
  • 输入：
    • query（字符串）：新闻搜索词
    • location（字符串，可选）：地理位置上下文
    • gl（字符串，可选）：Google 国家/地区代码
    • num（数字，可选）：结果数量（最多 20 条）

• serper_image_search

  • 搜索图片、照片、图表和视觉内容
  • 输入：
    • query（字符串）：图片搜索词
    • gl（字符串，可选）：Google 国家/地区代码（例如，“us”“in”“uk”）
    • num（数字，可选）：结果数量（最多 20 条）

• serper_video_search

  • 搜索 YouTube 和其他平台上的视频
  • 输入：
    • query（字符串）：视频搜索词
    • gl（字符串，可选）：Google 国家/地区代码（例如，“us”“in”“uk”）
    • num（数字，可选）：结果数量（最多 20 条）

• serper_maps_search

  • 搜索地点、商家和兴趣点
  • 输入：
    • query（字符串）：地点或商家搜索词
    • ll（字符串，可选）：格式为“@latitude,longitude,zoom”的位置坐标（例如，'@40.6973709,-74.1444871,11z'）
    • useCurrentLocation（布尔值，可选）：未提供坐标时是否使用基于 IP 的当前位置（默认值：true）
    • num（数字，可选）：结果数量（最多 20 条）
  • 返回：
    • 商家名称和地址
    • 地理坐标
    • 评分和评论
    • 商家类型和类别
    • 可用时的联系信息

• serper_reviews_search

  • 获取特定地点或商家的详细评论
  • 输入：
    • placeId（字符串）：Google Place ID（必填，可通过地图搜索获取）
    • cid（字符串，可选）：Google Customer ID（通过地图搜索获取）
    • fid（字符串，可选）：Google Featured ID（通过地图搜索获取）
    • sortBy（字符串，可选）：评论排序方式（“mostRelevant”“newest”“highestRating”“lowestRating”）
    • num（数字，可选）：返回的评论数量（最多 20 条）
  • 返回：
    • 详细的评论文本
    • 评分和日期信息
    • 评论者资料和统计数据
    • 点赞和用户互动数据

• gps_coordinates

  • 获取当前位置坐标
  • 输入：
    • fallbackToIP（布尔值，可选）：无法获取精确 GPS 位置时是否使用基于 IP 的地理定位（默认值：true）
  • 返回：
    • 纬度和经度
    • 精度信息
    • 用于在地图服务上查看位置的链接

• firecrawl_scrape

  • 抓取并提取任意网页的内容
  • 输入：
    • url（字符串）：要抓取页面的 URL
    • formats（数组，可选）：输出格式（默认值 ["markdown"]）

配置

获取 API 密钥

1. 注册 Serper.dev 账户
2. 注册 FireCrawl 账户
3. 在账户控制面板中生成 API 密钥

在 Claude Desktop 中使用

将以下内容添加到你的 claude_desktop_config.json 中：

Docker

{
  "mcpServers": {
    "serper": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "FIRECRAWL_API_KEY",
        "mcp/hs-search"
      ],
      "env": {
        "SERPER_API_KEY": "YOUR_SERPER_API_KEY_HERE",
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "serper": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-serper"
      ],
      "env": {
        "SERPER_API_KEY": "YOUR_SERPER_API_KEY_HERE",
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY_HERE"
      }
    }
  }
}

构建和运行

Docker 构建：

docker build -t mcp/hs-search:latest .

Docker 运行：

docker run -i --rm \
  -e SERPER_API_KEY="your-serper-api-key-here" \
  -e FIRECRAWL_API_KEY="your-firecrawl-api-key-here" \
  mcp/hs-search

本地开发：

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run server
SERPER_API_KEY="your-serper-api-key-here" FIRECRAWL_API_KEY="your-firecrawl-api-key-here" npm start

示例用法

以下是一些在 Claude 中使用这些工具的示例：

1. 网页搜索：

   Can you search for "climate change solutions" and summarize the results?
   

2. 新闻搜索：

   Find me the latest news about "artificial intelligence" in the United States.
   

3. 图片搜索：

   Can you find images of "Mars rover Perseverance" and describe what you see?
   

4. 视频搜索：

   Search for videos about "how to make sourdough bread" and summarize the top results.
   

5. 地图搜索：

   Search for "coffee shops" near me and tell me which ones have the highest ratings.
   

6. 评论搜索：

   Search for "Apple Store" and then get all the reviews for the highest-rated location.
   

7. 位置+地图集成：

   What's my current location? Now find Italian restaurants within 2 miles of me.
   

8. 地图+评论集成：

   Find the top-rated "pizza places" near me and show me their most recent reviews.
   

9. 获取位置：

   What is my current location? Can you show the coordinates on a map?
   

10. 网页抓取：

    搜索 TypeScript 接口相关的文档，然后抓取并解释其中一个搜索结果页面的内容。
    

许可证

此 MCP 服务采用 MIT 许可证。您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。