MCP Node Fetch

An MCP server that enables fetching web content using the Node.js undici library.

Features

• Fetch content from any URL using various HTTP methods
• Support for headers and request body
• Return content in various formats (text, JSON, binary, HTML fragments)
• Handle errors gracefully
• Configure timeout and redirect behavior

MCP Tools

This server provides the following MCP tools:

`fetch-url`

Fetches content from a URL and returns it.

Parameters:

• `url` (string, required): The URL to fetch
• `method` (string, optional): HTTP method (default: "GET")
• `headers` (object, optional): HTTP headers to include
• `body` (string, optional): Request body for POST/PUT requests
• `timeout` (number, optional): Request timeout in milliseconds
• `responseType` (string, optional): How to parse the response ("text", "json", "binary", "html-fragment")
• `fragmentSelector` (string, optional): CSS selector to extract specific HTML fragments (when responseType is "html-fragment")
• `followRedirects` (boolean, optional): Whether to follow redirects (default: true)

`extract-html-fragment`

Extracts specific HTML content from a webpage using CSS selectors and optionally navigates to anchor points.

Parameters:

• `url` (string, required): The URL to fetch
• `selector` (string, required): CSS selector for the HTML fragment to extract
• `anchorId` (string, optional): Optional anchor ID to locate a specific fragment
• `method` (string, optional): HTTP method (default: "GET")
• `headers` (object, optional): HTTP headers to include
• `body` (string, optional): Request body for POST requests
• `timeout` (number, optional): Request timeout in milliseconds
• `followRedirects` (boolean, optional): Whether to follow redirects (default: true)

`check-status`

Checks if a URL is accessible without downloading the full content.

Parameters:

• `url` (string, required): The URL to check
• `timeout` (number, optional): Request timeout in milliseconds

Claude for Desktop Configuration

To use with Claude for Desktop, add this to your `claude_desktop_config.json`:

{
  "mcpServers": {
    "node-fetch": {
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

License

MIT