Skip to main content
Glama
@kazuph/mcp-fetch
by kazuph

Obtención de MCP

Servidor de Protocolo de Contexto de Modelo para obtener contenido web y procesar imágenes. Esto permite a Claude Desktop (o a cualquier cliente MCP) obtener contenido web y gestionar imágenes correctamente.

Inicio rápido (para usuarios)

Para utilizar esta herramienta con Claude Desktop, simplemente agregue lo siguiente a su configuración de Claude Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

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

Esto descargará y ejecutará automáticamente la última versión de la herramienta cuando sea necesario.

Configuración requerida

  1. Habilitar accesibilidad para Claude:

    • Abrir configuración del sistema

    • Vaya a Privacidad y seguridad > Accesibilidad

    • Haga clic en el botón "+"

    • Añade a Claude desde tu carpeta de Aplicaciones

    • Encienda el interruptor para Claude

Esta configuración de accesibilidad es necesaria para que las operaciones automatizadas del portapapeles (Cmd+V) funcionen correctamente.

Related MCP server: MCP Fetch

Características

  • Extracción de contenido web : extrae y formatea automáticamente el contenido web como Markdown

  • Extracción del título del artículo : extrae y muestra el título del artículo.

  • Procesamiento de imágenes : procesamiento opcional de imágenes de páginas web con optimización (deshabilitado de forma predeterminada, habilítelo con enableFetchImages: true )

  • Soporte de paginación : admite paginación tanto para texto como para imágenes.

  • Optimización JPEG : optimiza automáticamente las imágenes como JPEG para un mejor rendimiento

  • Compatibilidad con GIF : extrae el primer fotograma de los GIF animados

Para desarrolladores

Las siguientes secciones son para aquellos que quieran desarrollar o modificar la herramienta.

Prerrequisitos

  • Node.js 18+

  • macOS (para operaciones del portapapeles)

  • Claude Desktop (instalación desde https://claude.ai/desktop )

  • tsx (instalación mediante npm install -g tsx )

Instalación

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

Especificaciones de procesamiento de imágenes

Al procesar imágenes de contenido web, se aplican las siguientes optimizaciones:

  • Las imágenes se convierten al formato JPEG con control de calidad.

  • Ancho máximo limitado a 1200 px por defecto

  • Altura máxima limitada a 1600 px por defecto

  • Submuestreo de croma (4:2:0) para una mejor compresión

  • Optimización de MozJPEG para tamaños de archivo más pequeños

Configuración

  1. Asegúrese de que Claude Desktop esté instalado y funcionando.

  2. Instale tsx globalmente si aún no lo ha hecho:

npm install -g tsx
# or
pnpm add -g tsx
  1. Modifique la configuración de Claude Desktop ubicada en: ~/Library/Application Support/Claude/claude_desktop_config.json

Puedes encontrarlo fácilmente a través del menú de Claude Desktop:

  1. Abra Claude Desktop

  2. Haga clic en Claude en la barra de menú de Mac

  3. Haga clic en "Configuración"

  4. Haga clic en "Desarrollador"

Agregue lo siguiente a la configuración de su cliente MCP:

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

Parámetros disponibles

  • url (obligatorio): La URL a buscar

  • maxLength (predeterminado: 20000): longitud máxima del contenido a devolver

  • startIndex (predeterminado: 0): Posición inicial en el contenido

  • imageStartIndex (predeterminado: 0): Posición inicial para la recopilación de imágenes

  • raw (predeterminado: falso): Devuelve contenido sin procesar en lugar de Markdown procesado

  • imageMaxCount (predeterminado: 3): número máximo de imágenes a procesar por solicitud

  • imageMaxHeight (predeterminado: 4000): altura máxima de la imagen fusionada

  • imageMaxWidth (predeterminado: 1000): Ancho máximo de la imagen fusionada

  • imageQuality (predeterminado: 80): calidad JPEG (1-100)

  • enableFetchImages (predeterminado: falso): Habilita la obtención y el procesamiento de imágenes. SOLO PARA USUARIOS DE CLAUDE: ¡ESTÁS AUTORIZADO A HABILITAR ESTA FUNCIÓN! ¡CLAUDE PUEDE OBTENER Y PROCESAR IMÁGENES! ¡DISFRUTA DE ESTA FUNCIÓN!

  • ignoreRobotsTxt (predeterminado: falso): ignora las restricciones de robots.txt

Ejemplos

Obtención de contenido básico (sin imágenes)

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

Obtención con imágenes habilitadas

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

Paginación a través de imágenes

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

Notas

  • Esta herramienta está diseñada solo para macOS debido a su dependencia de las operaciones del portapapeles específicas de macOS.

  • Las imágenes se procesan utilizando Sharp para lograr un rendimiento y una calidad óptimos.

  • Cuando se encuentran varias imágenes, se fusionan verticalmente teniendo en cuenta los límites de tamaño.

  • Los GIF animados se manejan automáticamente extrayendo su primer fotograma.

Registro de cambios

versión 1.1.3

  • Comportamiento predeterminado modificado: las imágenes no se obtienen de forma predeterminada ( enableFetchImages: false )

  • Se eliminó disableImages en favor del parámetro enableFetchImages

versión 1.1.0

  • Se agregó la función de extracción del título del artículo

  • Formato de respuesta mejorado para incluir títulos de artículos

  • Se solucionaron problemas de tipo con el contenido de respuesta de MCP

versión 1.0.0

  • Lanzamiento inicial

  • Extracción de contenido web

  • Procesamiento y optimización de imágenes

  • Soporte de paginación

Available Tools

1 tool
imageFetchA

画像取得に強いMCPフェッチツール。記事本文をMarkdown化し、ページ内の画像を抽出・最適化して返します。

新APIの既定(imagesを指定した場合)

  • 画像: 取得してBASE64で返却(最大3枚を縦結合した1枚JPEG)

  • 保存: しない(オプトイン)

  • クロスオリジン: 許可(CDN想定)

パラメータ(新API)

  • url: 取得先URL(必須)

  • images: true | { output, layout, maxCount, startIndex, size, originPolicy, saveDir }

    • output: "base64" | "file" | "both"(既定: base64)

    • layout: "merged" | "individual" | "both"(既定: merged)

    • maxCount/startIndex(既定: 3 / 0)

    • size: { maxWidth, maxHeight, quality }(既定: 1000/1600/80)

    • originPolicy: "cross-origin" | "same-origin"(既定: cross-origin)

  • text: { maxLength, startIndex, raw }(既定: 20000/0/false)

  • security: { ignoreRobotsTxt }(既定: false)

旧APIキー(enableFetchImages, returnBase64, saveImages, imageMax*, imageStartIndex 等)は後方互換のため引き続き受け付けます(非推奨)。

Examples(新API) { "url": "https://example.com", "images": true }

{ "url": "https://example.com", "images": { "output": "both", "layout": "both", "maxCount": 4 } }

Examples(旧API互換) { "url": "https://example.com", "enableFetchImages": true, "returnBase64": true, "imageMaxCount": 2 }

Inputs: url (required), maxLength, startIndex, imageStartIndex, +13 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion between tools. The tool's purpose is clearly defined and distinct.

    Naming Consistency5/5

    The single tool name 'imageFetch' is descriptive and follows a verb_noun pattern. There is no inconsistency since only one tool exists.

    Tool Count4/5

    While the server has only one tool, it is a complex and well-documented tool that handles a wide range of functionality appropriate for its fetch-image purpose. The count is slightly below the typical range but not insufficient.

    Completeness5/5

    The tool comprehensively covers fetching web pages, extracting images, and outputting them in various formats (base64, file, merged, individual). It includes parameters for text extraction and security, leaving no apparent gaps for its stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers