🚀 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 文件。