WebSearch MCP Server

WebSearch MCP Server

無料検索に対応し、URL のコンテンツを Markdown に変換するシンプルな検索サーバーです。中文

機能

• ウェブ検索： さまざまなプロバイダーを使用してウェブ検索を実行します。対応プロバイダー：Bing、Baidu、Google（browser_use を使用）。
• Markdown 変換： URL のコンテンツを Markdown 形式に変換します。
• WeChat 公式アカウントの記事： WeChat 公式アカウントの記事を検索し、コンテンツを取得します。
• 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