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.

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

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.

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

Asegúrese de que Claude Desktop esté instalado y funcionando.
Instale tsx globalmente si aún no lo ha hecho:

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

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:

Abra Claude Desktop
Haga clic en Claude en la barra de menú de Mac
Haga clic en "Configuración"
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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

fetch