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 페치

웹 콘텐츠를 가져오고 이미지를 처리하는 모델 컨텍스트 프로토콜 서버입니다. 이를 통해 Claude Desktop(또는 모든 MCP 클라이언트)이 웹 콘텐츠를 가져오고 이미지를 적절하게 처리할 수 있습니다.

빠른 시작(사용자용)

Claude Desktop과 함께 이 도구를 사용하려면 Claude Desktop 구성에 다음을 추가하기만 하면 됩니다( ~/Library/Application Support/Claude/claude_desktop_config.json ):

지엑스피1

필요할 때 도구의 최신 버전이 자동으로 다운로드되어 실행됩니다.

필수 설정

Claude의 접근성 활성화:
- 시스템 설정 열기
- 개인정보 보호 및 보안 > 접근성으로 이동하세요
- "+" 버튼을 클릭하세요
- 응용 프로그램 폴더에서 Claude를 추가하세요
- Claude의 토글을 켜세요

이 접근성 설정은 자동 클립보드 작업(Cmd+V)이 제대로 작동하는 데 필요합니다.

특징

웹 콘텐츠 추출 : 웹 콘텐츠를 마크다운으로 자동 추출하고 포맷합니다.
기사 제목 추출 : 기사 제목을 추출하여 표시합니다.
이미지 처리 : 최적화된 웹 페이지의 이미지에 대한 선택적 처리(기본적으로 비활성화됨, enableFetchImages: true 로 활성화)
페이지 매김 지원 : 텍스트와 이미지 모두에 대한 페이지 매김을 지원합니다.
JPEG 최적화 : 더 나은 성능을 위해 이미지를 JPEG로 자동 최적화합니다.
GIF 지원 : 애니메이션 GIF에서 첫 번째 프레임 추출

개발자를 위한

다음 섹션은 도구를 개발하거나 수정하려는 사람들을 위한 것입니다.

필수 조건

노드.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

이미지 처리 사양

웹 콘텐츠의 이미지를 처리할 때 다음과 같은 최적화가 적용됩니다.

이미지는 품질 관리를 통해 JPEG 형식으로 변환됩니다.
기본적으로 최대 너비는 1200px로 제한됩니다.
기본적으로 최대 높이는 1600px로 제한됩니다.
더 나은 압축을 위한 크로마 서브샘플링(4:2:0)
더 작은 파일 크기를 위한 MozJPEG 최적화

구성

Claude Desktop이 설치되어 실행 중인지 확인하세요.
아직 설치하지 않았다면 tsx를 전역적으로 설치하세요.

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

~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 Claude Desktop 구성을 수정하세요.

Claude Desktop 메뉴를 통해 쉽게 찾을 수 있습니다.

클로드 데스크톱 열기
Mac 메뉴 막대에서 Claude를 클릭하세요
"설정"을 클릭하세요
"개발자"를 클릭하세요

MCP 클라이언트 구성에 다음을 추가하세요.

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

사용 가능한 매개변수

url (필수): 가져올 URL
maxLength (기본값: 20000): 반환할 콘텐츠의 최대 길이
startIndex (기본값: 0): 콘텐츠의 시작 위치
imageStartIndex (기본값: 0): 이미지 수집 시작 위치
raw (기본값: false): 처리된 마크다운 대신 원시 콘텐츠를 반환합니다.
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는 첫 번째 프레임을 추출하여 자동으로 처리됩니다.

변경 사항

v1.1.3

변경된 기본 동작: 기본적으로 이미지를 가져오지 않습니다( enableFetchImages: false )
enableFetchImages 매개변수를 위해 disableImages 제거했습니다.

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

fetch