@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フェッチ

ウェブコンテンツの取得と画像処理のためのモデルコンテキストプロトコル(MCP)サーバー。これにより、Claude Desktop(または任意のMCPクライアント)はウェブコンテンツを取得し、画像を適切に処理できるようになります。

クイックスタート(ユーザー向け)

このツールを 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コンテンツを自動的に抽出し、マークダウンとしてフォーマットします
  • 記事タイトル抽出:記事のタイトルを抽出して表示します
  • 画像処理: ウェブページからの画像を最適化してオプションで処理します (デフォルトでは無効、 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形式に変換されます
  • 最大幅はデフォルトで1200ピクセルに制限されています
  • デフォルトでは最大高さは1600ピクセルに制限されています
  • 圧縮率を向上させるクロマサブサンプリング(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. クロードデスクトップを開く
  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 は、最初のフレームを抽出することによって自動的に処理されます。

変更履歴

バージョン1.1.3

  • デフォルトの動作を変更しました: デフォルトでは画像は取得されません ( enableFetchImages: false )
  • enableFetchImagesパラメータを優先してdisableImagesを削除しました

バージョン1.1.0

  • 記事タイトル抽出機能を追加
  • 記事のタイトルを含むように回答のフォーマットを改善しました
  • MCP 応答コンテンツのタイプに関する問題を修正しました

バージョン1.0.0

  • 初回リリース
  • Webコンテンツの抽出
  • 画像処理と最適化
  • ページネーションのサポート

You must be authenticated.

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

Tools

ウェブコンテンツの取得と画像処理のためのモデルコンテキストプロトコル(MCP)サーバー。これにより、Claude Desktop(または任意のMCPクライアント)はウェブコンテンツを取得し、画像を適切に処理できるようになります。

  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