MCP Web Utilities Server

Lightweight MCP server that exposes web search and page fetching tools for MCP clients.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rocwodev-mcpserver": {
      "command": "start_mcp_server.cmd",
      "args": []
    }
  }
}

The MCP Web Utilities Server is a lightweight MCP server that exposes web search and page fetching capabilities, enabling you to query the web and retrieve page content in a simplified Markdown format for integration with MCP clients.

How to use

You can leverage the MCP Web Utilities Server from an MCP client by invoking its tools to search the web, search within specific websites, or fetch and convert a webpage to Markdown. Use the search_on_web tool to retrieve broad results, search_on_website to constrain results to chosen sites, and fetch_webpage to obtain a readable Markdown rendering of any URL.

How to install

Prerequisites you need before running the server.

# Prerequisites
# - Python 3.13+
# - uv installed

Install and set up the environment, then prepare the crawler setup.

uv sync

# On Unix-like systems
.venv/bin/activate
crawl4ai-setup

# On Windows
.venv\Scripts\activate
crawl4ai-setup

Run the MCP Web Utilities Server using the runtime command shown, or use the Windows script if you are on a compatible system.

uv run main.py

start_mcp_server.cmd

Additional notes and tips

Avoid writing to STDOUT while the server is running, as extraneous output can interfere with JSON RPC communication. Network-dependent tests may fail if external services are blocked in your environment.

Tools

The server provides three core tools that you can call from your MCP client to perform web-related tasks.

search_on_web(query: str, results: int = 10) returns results formatted as title and description per result.

search_on_website(query: str, sites: list[str], results: int = 10) returns results formatted as title and description and is restricted to the provided sites.

fetch_webpage(target_url: str) returns a simplified Markdown rendering of the target page.

Available tools

search_on_web

Performs a web search using a web search backend and returns a list of results. Each result is formatted with a title and a short description.

search_on_website

Performs a constrained web search restricted to the specified list of websites and returns results with titles and descriptions.

fetch_webpage

Fetches a webpage and returns a simplified Markdown rendering suitable for quick reading and MCP integration.