# Serper的MCP服务

**Repository Path**: ccq/serpers-mcp-service

## Basic Information

- **Project Name**: Serper的MCP服务
- **Description**: 包装serper.dev的搜索接口为一个mcp服务，对外提供sse
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Serper的MCP服务

#### 介绍
包装serper.dev的搜索接口为一个mcp服务，对外提供sse

#### 软件架构
软件架构说明

#### 使用说明

1. 创建虚拟env `python -m venv venv && source venv/bin/activate`
2. 按照依赖 `pip install -r requirements.txt`
3. 启动服务 `python server.py`，看到`INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)`，说明服务启动成功
4. 提供dockerfile，`docker build -t mcp-serper-server .`后执行
```bash
docker run -d \
  --name mcp-server \
  -p 8000:8000 \
  -e SERPER_API_KEY="你的实际Serper API密钥" \
  mcp-serper-server
```

#### 模拟测试

1. 第一次初始化事件流 `curl -N -H "Accept: text/event-stream" http://0.0.0.0:8000/sse`，请保持该对话始终运行，出现类似`ping - 2026-01-05 08:32:58.920611+00:00`，说明sse接口工作正常
2. 另开一个终端，运行查询`python mcp_client.py`，输入你想查询内容，输入 exit 或 quit 退出程序