websearch-mcp-tools

# Web Search MCP Server 为 LLM 提供网页搜索能力的 MCP 服务器，支持从网页和新闻文章中获取并提取内容。 ## 功能特性 - **双搜索模式**: - **常规搜索**: 从博客、文档、文章等获取多样化的搜索结果 - **新闻搜索**: 从新闻源获取最新新闻文章和突发新闻 - **实时网页搜索**: 搜索任意主题，获取最新结果 - **内容提取**: 自动提取文章主要内容，过滤广告和无关信息 - **多种传输模式**: 支持 stdio、streamable-http、SSE 三种部署方式 - **负载均衡**: 支持多个 API 密钥，自动轮询分配 - **速率限制**: 内置速率限制（每小时 200 次），防止 API 滥用 - **结构化输出**: 返回包含元数据（标题、来源、日期、URL）的格式化内容 - **灵活结果**: 控制返回结果数量（1-20 条） ## 前置要求 1. **Serper API 密钥**: 在 [serper.dev](https://serper.dev) 注册获取 API 密钥 2. **Python 3.10+**: 确保已安装 Python 3. **uv**: Python 包管理器（通过 `curl -LsSf https://astral.sh/uv/install.sh | sh` 安装） 4. **MCP 兼容的 LLM 客户端**: 如 Claude Desktop、Cursor 或任何支持 MCP 的应用 ## 安装 1. 克隆或下载此仓库 2. 使用 uv 安装依赖： ```bash uv sync ``` 3. 设置 Serper API 密钥： ```bash export SERPER_API_KEYS="your-api-key-here" ``` 支持多密钥负载均衡，用逗号分隔： ```bash export SERPER_API_KEYS="key1,key2,key3" ``` ## 使用方法 ### 启动 MCP 服务器 服务器支持三种传输模式： #### stdio 模式（Claude Desktop 默认） ```bash uv run python main.py --transport stdio ``` #### streamable-http 模式 ```bash uv run python main.py --transport http --port 7860 ``` #### SSE 模式 ```bash uv run python main.py --transport sse --port 7860 ``` #### 使用已安装的命令 ```bash # 安装后可通过 pip install -e . web-search-mcp --transport stdio ``` **命令行选项**： - `--transport`: 传输模式（`stdio`、`http`、`sse`），默认：`stdio` - `--port`: HTTP/SSE 模式端口，默认：`7860` - `--log-level`: 日志级别（`DEBUG`、`INFO`、`WARNING`、`ERROR`），默认：`INFO` **环境变量**： - `SERPER_API_KEYS`: 逗号分隔的 API 密钥，用于负载均衡 - `PORT`: 覆盖默认端口（7860） - `LOG_LEVEL`: 覆盖默认日志级别（INFO） ### 连接 LLM 客户端 #### Claude Desktop（stdio 模式） 在 `claude_desktop_config.json` 中添加： ```json { "mcpServers": { "web-search": { "command": "uv", "args": ["run", "--directory", "/path/to/web-search-mcp", "python", "main.py", "--transport", "stdio"], "env": { "SERPER_API_KEYS": "your-api-key-here" } } } } ``` 或使用已安装的命令： ```json { "mcpServers": { "web-search": { "command": "web-search-mcp", "ar…