defuddle-mcp

A Model Context Protocol (MCP) server that extracts clean article content from web pages, removing clutter like ads, sidebars, and navigation elements.

Features

• 🧹 Clean Content Extraction - Removes ads, sidebars, and other distractions
• 📝 Markdown Output - Returns content in clean Markdown format with frontmatter
• 🚀 Zero Dependencies - Built with Node.js built-ins only
• ⚡ Fast & Lightweight - Minimal overhead, quick startup

Requirements

• Node.js >= 18 (for built-in fetch support)

Installation

Install from npm

npm install -g defuddle-mcp

Install from source

git clone https://github.com/ryanxili/defuddle-mcp.git
cd defuddle-mcp
npm install -g .

Usage

As a Global CLI Tool

defuddle-mcp

With MCP Host (e.g., Claude Desktop)

Add to your MCP configuration:

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

Or with global install:

{
  "mcpServers": {
    "defuddle": {
      "command": "defuddle-mcp"
    }
  }
}

Programmatically

node index.js

The server runs on stdio and communicates via JSON-RPC 2.0.

Tool: defuddle

Extract clean article content from a web page.

| Property | Type | Description | |----------|------|-------------| | url | string | The URL of the web page to extract content from (required) |

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "defuddle",
    "arguments": {
      "url": "https://example.com/article"
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "---\ntitle: Example Article\nsource: https://example.com/article\nlanguage: en\nword_count: 1234\n---\n\n# Article Content\n\n..."
      }
    ]
  }
}

API Reference

Methods

| Method | Description | |--------|-------------| | initialize | Initialize the MCP session | | tools/list | List available tools | | tools/call | Call a specific tool |

Error Codes

| Code | Message | Description | |------|---------|-------------| | -32700 | Parse error | Invalid JSON received | | -32601 | Method not found | Requested method does not exist |

License

MIT © Defuddle

Related

• Model Context Protocol - MCP specification
• defuddle.md - Content extraction API used by this server