Fetcher MCP is a web scraping and content extraction server powered by Playwright headless browser technology. It retrieves web pages with full JavaScript execution support and automatically extracts clean, readable content by filtering out ads, navigation elements, and other non-essential page components. Key features of Fetcher MCP: - JavaScript rendering for handling dynamic web applications, SPAs, and modern JavaScript-heavy sites - Intelligent content extraction using the Readability algorithm to isolate main article content - Flexible output formats including clean Markdown and raw HTML - Parallel batch processing via the `fetch_urls` tool for concurrent fetching of multiple URLs - Resource optimization that blocks unnecessary assets (images, stylesheets, fonts, media) to reduce bandwidth - Configurable parameters for timeouts, content extraction behavior, and output formatting

中文 | Deutsch | Español | français | 日本語 | 한국어 | Português | Русский

Fetcher MCP

MCP server for fetch web page content using Playwright headless browser.

> 🌟 Recommended: OllaMan - Powerful Ollama AI Model Manager.

Advantages

Quick Start

Run directly with npx:

npx -y fetcher-mcp

First time setup - install the required browser by running the following command in your terminal:

npx playwright install chromium

HTTP and SSE Transport

Use the --transport=http parameter to start both Streamable HTTP endpoint and SSE endpoint services simultaneously:

npx -y fetcher-mcp --log --transport=http --host=0.0.0.0 --port=3000

After startup, the server provides the following endpoints:

Clients can choose which method to connect based on their needs.

Debug Mode

Run with the --debug option to show the browser window for debugging:

npx -y fetcher-mcp --debug

Configuration MCP

Configure this MCP server in Claude Desktop:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fetcher": {
      "command": "npx",
      "args": ["-y", "fetcher-mcp"]
    }
  }
}

Docker Deployment

Running with Docker

docker run -p 3000:3000 ghcr.io/jae-jae/fetcher-mcp:latest

Deploying with Docker Compose

Create a docker-compose.yml file:

version: "3.8"
services:
  fetcher-mcp:
    image: ghcr.io/jae-jae/fetcher-mcp:latest
    container_name: fetcher-mcp
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    # Using host network mode on Linux hosts can improve browser access efficiency
    # network_mode: "host"
    volumes:
      # For Playwright, may need to share certain system paths
      - /tmp:/tmp
    # Health check
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000"]
      interval: 30s
      timeout: 10s
      retries: 3

Then run:

docker-compose up -d

Features

- Uses Playwright headless browser to parse JavaScript - Supports intelligent extraction of main content and conversion to Markdown - Supports the following parameters: - url: The URL of the web page to fetch (required parameter) - timeout: Page loading timeout in milliseconds, default is 30000 (30 seconds) - waitUntil: Specifies when navigation is considered complete, options: 'load', 'domcontentloaded', 'networkidle', 'commit', default is 'load' - extractContent: Whether to intelligently extract the main content, default is true - maxLength: Maximum length of returned content (in characters), default is no limit - returnHtml: Whether to return HTML content instead of Markdown, default is false - waitForNavigation: Whether to wait for additional navigation after initial page load (useful for sites with anti-bot verification), default is false - `navigationTimeout