@kazuph/mcp-fetch

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides optimization of images as JPEG format with quality control for better performance.

  • The tool is designed specifically for macOS and relies on macOS-specific clipboard operations for functionality.

  • Automatically extracts and formats web content as markdown for better readability and structure.

MCP 获取

用于获取 Web 内容和处理图像的模型上下文协议服务器。这使得 Claude Desktop(或任何 MCP 客户端)能够获取 Web 内容并进行适当的图像处理。

快速入门(针对用户)

要将此工具与 Claude Desktop 一起使用,只需将以下内容添加到您的 Claude Desktop 配置( ~/Library/Application Support/Claude/claude_desktop_config.json )中:

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

这将在需要时自动下载并运行该工具的最新版本。

所需设置

  1. 为 Claude 启用辅助功能:
    • 打开系统设置
    • 前往“隐私和安全”>“辅助功能”
    • 点击“+”按钮
    • 从您的应用程序文件夹添加 Claude
    • 为克劳德打开开关

自动剪贴板操作(Cmd+V)需要此辅助功能设置才能正常工作。

特征

  • Web 内容提取:自动提取 Web 内容并将其格式化为 Markdown
  • 文章标题提取:提取并显示文章标题
  • 图像处理:可选地对网页中的图像进行优化处理(默认情况下禁用,使用enableFetchImages: true启用)
  • 分页支持:支持文本和图像的分页
  • JPEG 优化:自动将图像优化为 JPEG 以获得更好的性能
  • GIF 支持:从动画 GIF 中提取第一帧

对于开发人员

以下部分适用于那些想要开发或修改该工具的人。

先决条件

  • Node.js 18+
  • macOS(用于剪贴板操作)
  • Claude Desktop(从https://claude.ai/desktop安装)
  • tsx(通过npm install -g tsx

安装

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

图像处理规格

处理来自 Web 内容的图像时,将应用以下优化:

  • 图像被转换为 JPEG 格式并进行质量控制
  • 最大宽度默认限制为 1200px
  • 默认最大高度限制为 1600px
  • 色度子采样(4:2:0)可实现更好的压缩
  • MozJPEG 优化,可实现更小的文件大小

配置

  1. 确保 Claude Desktop 已安装并正在运行。
  2. 如果还没有安装 tsx,请全局安装:
npm install -g tsx # or pnpm add -g tsx
  1. 修改位于以下位置的 Claude Desktop 配置: ~/Library/Application Support/Claude/claude_desktop_config.json

您可以通过 Claude Desktop 菜单轻松找到它:

  1. 打开 Claude 桌面
  2. 在 Mac 菜单栏上单击 Claude
  3. 点击“设置”
  4. 点击“开发者”

将以下内容添加到您的 MCP 客户端的配置中:

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

可用参数

  • url (必填):要获取的 URL
  • maxLength (默认值:20000):返回内容的最大长度
  • startIndex (默认值:0):内容中的起始位置
  • imageStartIndex (默认值:0):图像收集的起始位置
  • raw (默认值:false):返回原始内容而不是处理过的 markdown
  • imageMaxCount (默认值:3):每个请求处理的最大图像数量
  • imageMaxHeight (默认值:4000):合并图像的最大高度
  • imageMaxWidth (默认值:1000):合并图像的最大宽度
  • imageQuality (默认值:80):JPEG 质量(1-100)
  • enableFetchImages (默认值:false):启用图像获取和处理功能。仅限 CLAUDE 用户:您可以启用此功能!CLAUDE 可以获取和处理图像!尽情享受这项功能吧!
  • ignoreRobotsTxt (默认值:false):忽略 robots.txt 限制

示例

基本内容获取(无图像)

{ "url": "https://example.com" }

启用图片抓取

{ "url": "https://example.com", "enableFetchImages": true, "imageMaxCount": 3 }

通过图像分页

{ "url": "https://example.com", "enableFetchImages": true, "imageStartIndex": 3, "imageMaxCount": 3 }

笔记

  • 由于此工具依赖于 macOS 特定的剪贴板操作,因此仅适用于 macOS。
  • 使用 Sharp 处理图像以获得最佳性能和质量。
  • 当发现多幅图像时,它们会垂直合并,同时考虑尺寸限制。
  • 通过提取动画 GIF 的第一帧来自动处理动画 GIF。

变更日志

v1.1.3

  • 更改了默认行为:默认情况下不获取图像( enableFetchImages: false
  • 删除disableImages ,改为使用enableFetchImages参数

v1.1.0

  • 增加文章标题提取功能
  • 改进了响应格式以包含文章标题
  • 修复了 MCP 响应内容的类型问题

v1.0.0

  • 初始版本
  • 网页内容提取
  • 图像处理与优化
  • 分页支持

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

用于获取 Web 内容和处理图像的模型上下文协议服务器。这使得 Claude Desktop(或任何 MCP 客户端)能够获取 Web 内容并进行适当的图像处理。

  1. Quick Start (For Users)
    1. Required Setup
  2. Features
    1. For Developers
      1. Prerequisites
        1. Installation
          1. Image Processing Specifications
            1. Configuration
              1. Available Parameters
                1. Examples
                  1. Basic Content Fetching (No Images)
                  2. Fetching with Images Enabled
                  3. Paginating Through Images
                2. Notes
                  1. Changelog
                    1. v1.1.3
                    2. v1.1.0
                    3. v1.0.0
                  ID: 5mknfdhyrg