网页搜索与Markdown转换服务

一个支持多种搜索引擎的网页搜索服务器,能够将URL内容转换为Markdown格式,并提供微信公众号文章和GitHub内容的搜索功能。

  • by Howe829
  • Python
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 Howe829/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
    
  2. 使用uv(重新编译)安装依赖项:

    uv venv && uv sync
    

    或者,如果你更喜欢使用pip:

    pip install -r requirements.txt
    

配置

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

    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 inputor调试此服务器

uv run fastmcp dev server.py