https://github.com/howe829/websearch-mcp-server
MCP server for agent web search
https://github.com/howe829/websearch-mcp-server
Last synced: 3 months ago
JSON representation
MCP server for agent web search
- Host: GitHub
- URL: https://github.com/howe829/websearch-mcp-server
- Owner: Howe829
- License: mit
- Created: 2025-05-27T09:15:27.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-05T09:33:23.000Z (4 months ago)
- Last Synced: 2025-06-05T10:33:31.928Z (4 months ago)
- Language: Python
- Homepage:
- Size: 252 KB
- Stars: 11
- Watchers: 0
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WebSearch MCP Server
A simple web search server that supports free search and converts URL content to Markdown. [δΈζ](README-zh.md)
## Features
- **Web Search:** Perform web searches using different providers. Supported providers: Bing, Baidu, Google(with browser_use).
- **Markdown Conversion:** Convert the content of a URL into Markdown format.
- **Wechat Official Account Articles:** Search and retrive wechat official account articles content.
- **GitHub Search:** Easily search for anything on GitHub β repositories, users, issues, and more.
## Getting Started
### Prerequisites
- Python 3.12 or higher
- uv for dependency management (or pip)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/Howe829/websearch-mcp-server.git
cd websearch-mcp-server
```
2. Install the dependencies using uv (Recomend):
```bash
uv venv && uv sync
```
Or, if you prefer using pip:
```bash
pip install -r requirements.txt
```
### Configuration
1. Create a `.env` file based on the `.env.example` file:
```bash
cp .env.example .env
```
2. Modify the `.env` file with your desired settings:
```
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
```
### Usage
Run the server using uv:
```bash
uv run python server.py
```
Or run the server using python:
```bash
source .venv/bin/activate
python server.py
```
## Contribution
Contributions are welcome!
This project uses pytest for unit tests
```bash
uv pip install pytest
uv pip install pytest-asyncio
uv run pytest
```
And use the ruff for code sytle formatting
```bash
uv pip install ruff
ruff format .
```
use mcp inpector to debug this server
```bash
uv run fastmcp dev server.py
```