MCP 페치

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

빠른 시작(사용자용)

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

지엑스피1

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

필수 설정

1. Claude의 접근성 활성화:

   • 시스템 설정 열기

   • 개인정보 보호 및 보안 > 접근성으로 이동하세요

   • "+" 버튼을 클릭하세요

   • 응용 프로그램 폴더에서 Claude를 추가하세요

   • Claude의 토글을 켜세요

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

Related MCP server: MCP Fetch

특징

• 웹 콘텐츠 추출 : 웹 콘텐츠를 마크다운으로 자동 추출하고 포맷합니다.

• 기사 제목 추출 : 기사 제목을 추출하여 표시합니다.

• 이미지 처리 : 최적화된 웹 페이지의 이미지에 대한 선택적 처리(기본적으로 비활성화됨, 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 최적화

구성

1. Claude Desktop이 설치되어 실행 중인지 확인하세요.

2. 아직 설치하지 않았다면 tsx를 전역적으로 설치하세요.

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

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

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

1. 클로드 데스크톱 열기

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): 처리된 마크다운 대신 원시 콘텐츠를 반환합니다.

• 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

• 최초 출시

• 웹 콘텐츠 추출

• 이미지 처리 및 최적화

• 페이지 매김 지원