WebSearch MCP Server

WebSearch MCP服务器

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

特性

• 网络搜索： 使用不同的提供商执行网络搜索。支持的提供商：必应、百度、谷歌（带浏览器）。
• 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

1. 使用uv（重新编译）安装依赖项：

   uv venv && uv sync

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

   pip install -r requirements.txt

配置

1. 创建一个 .env 文件基于 .env.example 文件：

   cp .env.example .env

1. 修改 .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 inputor调试此服务器

uv run fastmcp dev server.py