MCP Fetch

Model Context Protocol server for fetching web content with custom http proxy. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.

<a href="https://glama.ai/mcp/servers/@kwp-lab/mcp-fetch"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@kwp-lab/mcp-fetch/badge" /> </a>

This repository forks from the @smithery/mcp-fetch and replaces the node-fetch implementation with the library node-fetch-native.

The server will use the http_proxy and https_proxy environment variables to route requests through the proxy server by default if they are set. You also can set the MCP_HTTP_PROXY environment variable to use a different proxy server.

Available Tools

• fetch: Retrieves URLs from the Internet and extracts their content as markdown. If images are found, their URLs will be included in the response.

Image Processing Specifications:

Only extract image urls from the article content, and append them to the tool result:

{
  "params": {
    "url": "https://www.example.com/articles/123"
  },
  "response": {
    "content": [
      {
        "type": "text",
        "text": "Contents of https://www.example.com/articles/123:
Here is the article content

Images found in article:
- https://www.example.com/1.jpg.webp
- https://www.example.com/2.jpg.webp
- https://www.example.com/3.webp"
      }
    ]
  }
}

Quick Start (For Users)

To use this tool with Claude Desktop, simply add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "tools": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@kwp-lab/mcp-fetch"],
      "env": {
        "MCP_HTTP_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

This will automatically download and run the latest version of the tool when needed.

Required Setup

1. Enable Accessibility for Claude:
   • Open System Settings
   • Go to Privacy & Security > Accessibility
   • Click the "+" button
   • Add Claude from your Applications folder
   • Turn ON the toggle for Claude

For Developers

The following sections are for those who want to develop or modify the tool.

Prerequisites

• Node.js 18+
• Claude Desktop (install from https://claude.ai/desktop)
• tsx (install via npm install -g tsx)

Installation

Installing via Smithery

To install MCP Fetch for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kwp-lab/mcp-fetch --client claude

Manual Installation

git clone https://github.com/kwp-lab/mcp-fetch.git
cd mcp-fetch
npm install
npm run build

Configuration

1. Make sure Claude Desktop is installed and running.

2. Install tsx globally if you haven't:

   npm install -g tsx
   # or
   pnpm add -g tsx
   

3. Modify your Claude Desktop config located at:

~/Library/Application Support/Claude/claude_desktop_config.json

You can easily find this through the Claude Desktop menu:

1. Open Claude Desktop
2. Click Claude on the Mac menu bar
3. Click "Settings"
4. Click "Developer"

Add the following to your MCP client's configuration:

{
  "tools": {
    "fetch": {
      "args": ["tsx", "/path/to/mcp-fetch/index.ts"]
    }
  }
}