SerpApi MCP 服务器

构建一个 MCP 服务器，它可以：

• 通过 SerpApi 使用 API 密钥快速获取解析后的搜索引擎结果页面

此 MCP（模型上下文协议）服务器与 SerpApi 集成，以跨各种搜索引擎执行搜索并检索实时和存档结果。它公开了工具和资源，用于与 MCP 客户端或主机（例如 Grok 或 Claude for Desktop）进行无缝交互。

---

安装

要设置 SerpApi MCP 服务器，请安装所需的 Python 库：

pip install mcp serpapi python-dotenv

您还需要一个 SerpApi API 密钥。在 SerpApi 注册以获取一个。

快速开始

1. 保存服务器代码：将服务器代码放在一个文件中，例如 server.py。

2. 配置 API 密钥：在同一目录下创建一个 .env 文件，其中包含您的 SerpApi API 密钥：

SERPAPI_API_KEY=your_api_key_here

3. 运行服务器：使用以下命令启动服务器：

python server.py

4. 与 MCP 客户端集成：将服务器连接到 MCP 客户端或主机（例如 Claude for Desktop）。对于 Claude，更新 Claude_desktop_config.json：

{
  "mcpServers": {
    "serpapi": {
      "command": "python",
      "args": ["path/to/server.py"]
    }
  }
}

重新启动客户端以加载服务器。

特性

• 支持的引擎：Google, Google Light, Bing, Walmart, Yahoo, eBay, YouTube, DuckDuckGo, Yandex, Baidu

• 工具:

• search: 在指定的引擎上使用查询和可选参数执行搜索。

• 资源:

• locations: 查找 Google 位置。

使用示例

这些示例假设 MCP 客户端（例如，使用 MCP 客户端 SDK 用 Python 编写）已连接到服务器。 列出支持的引擎 检索支持的搜索引擎列表：

engines = await session.read_resource("locations")
print(engines)

执行搜索 在 Google 上搜索“coffee”，并带有位置过滤器：

result = await session.call_tool("search", {
    "query": "coffee",
    "engine": "google",
    "location": "Austin, TX"
})

print(result)

配置

API 密钥：在 .env 文件中将您的 SerpApi API 密钥设置为 SERPAPI_API_KEY。

运行服务器

生产模式：使用以下命令启动服务器：

python server.py

开发模式：使用 MCP Inspector 进行调试：

mcp dev server.py

测试

使用 MCP Inspector 或 MCP 客户端测试服务器。对于 Claude for Desktop，在 Claude_desktop_config.json 中配置服务器，重新启动应用程序，然后使用锤子图标来探索和测试可用的工具。