WebSearch MCP Server

WebSearch MCP Server

一个简单的网络搜索服务，支持免费搜索，并可将 URL 内容转换为 Markdown。中文

功能

• 网络搜索： 使用不同的服务提供商执行网络搜索。支持的服务提供商：Bing、Baidu、Google（使用 browser_use）。
• Markdown 转换： 将 URL 的内容转换为 Markdown 格式。
• 微信公众号文章： 搜索并获取微信公众号文章内容。
• GitHub 搜索： 轻松搜索 GitHub 上的内容——仓库、用户、议题等。

快速开始

前提条件

• Python 3.12 或更高版本
• 使用 uv 管理依赖（或 pip）

安装

1. 克隆仓库：

   git clone https://github.com/Howe829/websearch-mcp-server.git
   cd websearch-mcp-server
   

2. 使用 uv 安装依赖（推荐）：

   uv venv && uv sync
   

   或者，如果你更喜欢使用 pip：

   pip install -r requirements.txt
   

配置

1. 根据 .env.example 文件创建 .env 文件：

   cp .env.example .env
   

2. 根据需要修改 .env 文件：

   BING_SEARCH_BASE_URL="https://www.bing.com"
   LANGUAGE="en"
   CC="us"
   IMPERSONATE="edge"
   HOST=127.0.0.1
   PORT=8002
   SERVER_MODE=streamable-http
   

使用方法

使用 uv 运行服务：

uv run python server.py

或者使用 python 运行服务：

source .venv/bin/activate
python server.py

贡献

欢迎贡献！

本项目使用 pytest 进行单元测试

uv pip install pytest
uv pip install pytest-asyncio
uv run pytest

并使用 ruff 进行代码风格格式化

uv pip install ruff
ruff format .

使用 mcp inpector 调试此服务

uv run fastmcp dev server.py