搜索引擎集成服务

MCP服务器示例

构建一个MCP服务器，该服务器：

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

安装

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

pip install mcp serpapi python-dotenv

你还需要一个 SerpApi API密钥。在SerpApi注册即可获得一个。

快速开始

1. 保存服务器代码：将服务器代码放入文件中，例如Server.py。

2. 配置API密钥：使用SerpApi API密钥在同一目录中创建.env文件：

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、沃尔玛、雅虎、eBay、YouTube、DuckDuckGo、Yandex、百度

• 工具:

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

• 资源:

• 地点：查找谷歌地点。

使用示例

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

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

执行搜索 使用位置过滤器在谷歌上搜索“咖啡”：

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

打印（结果）

配置

API密钥：在 .env 文件为 SERPAPI_API_KEY.

运行服务器

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

python server.py

开发模式：使用MCP检查器进行调试：

mcp dev server.py

测试

使用MCP检查器或MCP客户端测试服务器。对于Claude For Desktop，请在中配置服务器 Claude_desktop_config.json，重新启动应用程序，并使用锤子图标探索和测试可用工具。