Serper Search

🚀 MCP 服务器 Serper

本项目是基于 Python 的 MCP（模型上下文协议）服务器，借助 API Serper 开展网络搜索，有效解决信息获取难题，为用户提供便捷的网络搜索服务。

🚀 快速开始

本项目实现了一个遵循 MCP 协议的服务器，具备以下功能：

• 传输 Server-Sent Events (SSE)
• 通过 API Serper 实现网络搜索
• 提取网页内容
• 服务健康状态检查

✨ 主要特性

• SSE 传输：支持 Server-Sent Events (SSE) 传输，实现服务器与客户端之间的实时通信。
• 网络搜索：借助 API Serper 进行网络搜索，获取丰富的网络信息。
• 内容提取：能够提取网页内容，方便用户获取所需信息。
• 健康检查：提供服务健康状态检查功能，确保服务的稳定性。

📦 安装指南

先决条件

• Python 3.8 或更高版本
• Serper API 账户（https://serper.dev）

安装步骤

1. 克隆仓库：

git clone https://github.com/seu-usuario/mcp-server-serper.git
cd mcp-server-serper

2. 安装项目：

pip install -e .

💻 使用示例

启动服务器

mcp-server-serper

或直接通过 Python 运行：

python -m mcp_server_serper.main

连接到服务器

服务器暴露以下端点：

• GET /：显示基本信息页面
• GET /sse：用于连接到 MCP 客户端的 SSE 端点
• POST /messages：接收来自客户端的消息

可用工具

• google_search：通过 Serper API 实现网络搜索
• scrape：提取网页内容
• _health：检查服务健康状态

📚 详细文档

配置

在项目根目录下创建一个 .env 文件，包含以下变量：

SERPER_API_KEY=sua_chave_api_serper
MCP_TOKEN=seu_token_autenticacao  # 可选
HOST=127.0.0.1  # 可选，默认：127.0.0.1
PORT=3001  # 可选，默认：3001

🔧 技术细节

开发流程

1. 安装开发依赖项：

pip install -e ".[dev]"

2. 运行测试：

pytest

3. 检查代码质量：

black .
isort .
mypy src
flake8

📄 许可证

该项目根据 MIT 许可证发布，详细信息请查看 LICENSE 文件。