JinDaGe - Serper Search MCP Details

article

README

🚀 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）

安装步骤

克隆仓库：

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

安装项目：

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

🔧 技术细节

开发流程

安装开发依赖项：

pip install -e ".[dev]"

运行测试：

pytest

检查代码质量：

black .
isort .
mypy src
flake8

📄 许可证

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

Serper Search