AI导哈

谷歌搜索服务

Serper MCP服务器提供通过Serper进行Google搜索的功能，包括标准搜索、图像搜索、视频搜索、地点搜索、评论搜索等多种搜索类型，适用于需要集成Google搜索功能的开发场景。

  • by samy-clivolt
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 samy-clivolt/serper-mcp-server-fixed

使用说明

Serper MCP服务器（修复版）

🚀 具有特定端点和完全参数支持的Serper MCP服务器的修复版本

提供的Model Context Protocol服务器 通过Serper进行谷歌搜索 根据官方Serper文档更正端点。

🆕 此版本中的更正

  • ✅ 特定端点 ：为每种类型的搜索使用正确的端点
  • ✅ 地点搜索 ：修正端点 https://google.serper.dev/places
  • ✅ 评论搜索 ：修正端点 https://google.serper.dev/reviews
  • ✅ 新的PlacesRequest方案 ：为位置搜索优化的设置
  • ✅ ReviewsRequest改进 参数： fid 可选渲染
  • ✅ 支持完成 ：参数 gl, hl, location 正确管理
  • ✅ 测试有效 ：根据实际用例验证操作

📋 可用工具

  • google_search -搜索谷歌标准
  • google_search_images -图片检索
  • google_search_videos -搜索视频
  • google_search_places - [更正] 搜索具有特定端点的位置
  • google_search_maps -搜索谷歌地图
  • google_search_reviews - [更正] 使用灵活设置搜索评论
  • google_search_news -新闻搜索
  • google_search_shopping -重新搜索购物
  • google_search_lens -搜索谷歌镜头
  • google_search_scholar -搜索谷歌学者
  • google_search_parents -重新审视父母
  • google_search_autocomplete -自动完成
  • webpage_scrape -网页抓取

🔧 使用

配置avec uv （推荐）

  1. 确保已安装 uv 在你的系统上。

  2. 在MCP客户端配置或设置中 克劳德 （文件 claude_desktop_config.json），添加Serper MCP服务器：

    {
    "mcpServers": {
        "serper": {
            "command": "uvx",
            "args": ["serper-mcp-server"],
            "env": {
                "SERPER_API_KEY": "<Votre clé API Serper>"
            }
        }
    }
}

配置avec pip

  1. 安装软件包：

    pip install serper-mcp-server

  2. MCP客户端的配置：

    {
    "mcpServers": {
        "serper": {
            "command": "python3",
            "args": ["-m", "serper_mcp_server"],
            "env": {
                "SERPER_API_KEY": "<Votre clé API Serper>"
            }
        }
    }
}

🧪 使用示例

搜索地点（地点）

# Recherche de lieux avec les paramètres corrigés
{
    "q": "Smartch",
    "location": "France", 
    "gl": "fr",
    "hl": "fr"
}

搜索评论（评论）

# Recherche d'avis avec CID obtenu via Places
{
    "cid": "17077932821649815749",
    "gl": "fr",
    "hl": "fr"
}

🐛 调试

您可以使用MCP检查器调试服务器：

npx @modelcontextprotocol/inspector uvx serper-mcp-server

或用于地方发展：

cd path/to/servers/src/serper
npx @modelcontextprotocol/inspector uv run serper-mcp-server -e SERPER_API_KEY=<votre-clé>

📝 更新日志

修正版（2024年）

  • [修复] 修复端点以匹配Serper文档
  • 新 添加特定的PlacesRequest模式
  • [改进] ReviewsRequest中的可选FID参数
  • [测试] 真实用例的完整验证

原始版本

  • Serper MCP服务器的初始实现
  • 对所有类型搜索的基本支持

🔑 获取Serper API密钥

  1. 在上创建帐户 瑟珀·德夫
  2. 从仪表板获取API密钥
  3. 配置环境变量 SERPER_API_KEY

📄 许可证

此Serper MCP服务器根据MIT许可证授权。您可以根据MIT许可条款自由使用、修改和分发软件。

相关 MCP