MCP Fetch

🚀 MCP Fetch

A Model Context Protocol server for scraping web content and processing images. This allows Claude Desktop (or other MCP clients) to scrape web content and handle images appropriately.

🚀 Quick Start (Users)

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

{
  "tools": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-fetch"]
    }
  }
}

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

Required Settings

1. Enable Claude's accessibility features:
   • Open System Settings.
   • Go to "Privacy & Security" > "Accessibility".
   • Click the "+" button.
   • Add Claude from the Applications folder.
   • Toggle on Claude.

This accessibility setting is required for automatic clipboard operations (Cmd+V) to work properly.

📝 Developer Notes

The following section is for those who wish to develop or modify the tool.

🛠️ Prerequisites

• Node.js 18+
• macOS (for clipboard operations)
• Claude Desktop (download and install from https://claude.ai/desktop)
• tsx (install via npm install -g tsx)

📦 Installation

Install via Smithery

To automatically install MCP Fetch via Smithery:

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

Manual Installation

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

🖼️ Image Processing Specifications

When scraping images from web content, the following restrictions will apply:

• A maximum of 6 images per group.
• A maximum height of 8000 pixels per group.
• A maximum size of 30MB per group.

If the content exceeds these limits, the images will be automatically divided into multiple groups, and multiple pastes (Cmd+V) may be required.

⚙️ Configuration

1. Ensure that Claude Desktop is installed and running.

2. Install tsx globally if not already installed:

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

3. Modify your Claude Desktop configuration file located at: ~/Library/Application Support/Claude/claude_desktop_config.json

You can easily find this file by following these steps:

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

Add the following to your MCP client configuration:

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

🛠️ Available Tools

• fetch: Scrapes URLs from the Internet and extracts their content as Markdown. Images will be automatically processed and prepared for clipboard operations.

⚠️ Important Notes

• This tool is designed specifically for macOS due to its reliance on macOS-specific clipboard operations.
• Images are processed using Sharp for optimal performance and quality.
• When multiple images are found, they are vertically merged while considering size limitations.
• Animated GIFs are automatically processed by extracting their first frame.