Advertise SubmitSign In

Web MCP Server

@zgagnon

About Web MCP Server

a try at writing an mcp server. might replace one of my emacs tools

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "web-mcp-server": {
      "command": "npx",
      "args": [
        "https://zgagnon.com/webmcp"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Web MCP Server?

Web MCP Server is a Model Context Protocol server that provides web search and content retrieval tools for AI assistants. It integrates with DuckDuckGo for search and uses Mozilla Readability to fetch and clean web page content.

How to use Web MCP Server?

Install dependencies with npm install, then run npm run dev for development or npm run build followed by npm start for production. It can also be run directly via npx https://zgagnon.com/webmcp or nix run github:zgagnon.com/webmcp.

Key features of Web MCP Server

search_duckduckgo: performs web searches returning result URLs
read_url: fetches URLs and extracts plain text content
Uses DuckDuckGo for privacy-focused search
Uses Mozilla Readability for HTML content extraction
Returned text can be truncated to fit context window limits

Use cases of Web MCP Server

AI assistant performing web searches on demand
AI assistant reading web pages while removing clutter
Content summarization from live URLs
Privacy-friendly web search without tracking
Fetching article text for further processing

FAQ from Web MCP Server

What tools does Web MCP Server provide?

It provides two tools: search_duckduckgo for web search and read_url for fetching and cleaning web content.

How do I run Web MCP Server?

Locally via npm install then npm run dev or npm start, or on the fly with npx or nix as shown in the README.

Does `search_duckduckgo` return full page content?

No, it returns only a list of URLs matching the search query.

What parameters does `read_url` accept?

It requires a url string and accepts optional useReadabilityMode (default true) and maxLength (default 10000 characters).

What happens if a tool call fails?

The server returns an error for invalid arguments, URL fetch failures, or search execution failures.

Frequently asked questions

What tools does Web MCP Server provide?

It provides two tools: `search_duckduckgo` for web search and `read_url` for fetching and cleaning web content.

How do I run Web MCP Server?

Locally via `npm install` then `npm run dev` or `npm start`, or on the fly with `npx` or `nix` as shown in the README.

Does `search_duckduckgo` return full page content?

No, it returns only a list of URLs matching the search query.

What parameters does `read_url` accept?

It requires a `url` string and accepts optional `useReadabilityMode` (default true) and `maxLength` (default 10000 characters).

What happens if a tool call fails?

The server returns an error for invalid arguments, URL fetch failures, or search execution failures.

Comments

Basic information

Category

Other

Transports

stdio

Author

zgagnon

More Other MCP servers

Mcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

Inbox Zero AI

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

Awesome Mlops

A curated list of references for MLOps

ghidraMCP

MCP Server for Ghidra

XcodeBuildMCP

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.