Fetch With Images

🚀 MCP 抓取ツール

Model Context Protocol サーバーは、Webコンテンツを取得し、画像を処理するために使用されます。これにより、Claude Desktop（またはその他のMCPクライアント）がWebページのコンテンツを取得し、画像を適切に処理できるようになります。

🚀 クイックスタート（ユーザー）

このツールをClaude Desktopと一緒に使用するには、以下の内容をClaude Desktopの設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に追加してください。

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

これにより、最新バージョンのツールが自動的にダウンロードされ、必要に応じて実行されます。

必要な設定

1. Claudeのアクセシビリティ機能を有効にする：
   • システム設定を開く
   • プライバシーとセキュリティ > アクセシビリティに移動
   • “+” ボタンをクリック
   • アプリケーションフォルダからClaudeを追加
   • Claudeの横のスイッチをオンにする

このアクセシビリティ設定は、クリップボード操作（Cmd+V）を自動的に実行するために必要です。

✨ 主な機能

• Webコンテンツの抽出：Webページのコンテンツを自動的に抽出し、Markdown形式に整形します。
• 記事タイトルの抽出：記事のタイトルを抽出して表示します。
• 画像処理：Webページ内の画像をオプションで処理し、最適化機能付き（デフォルトでは無効。enableFetchImages: true を設定すると有効になります）。
• ページ分割サポート：テキストと画像のページ分割をサポートします。
• JPEG最適化：画像を自動的にJPEG形式に変換し、品質を制御します。
• GIFサポート：アニメーションGIFの最初のフレームを抽出します。

🔧 開発者向け情報

以下のセクションは、このツールを開発または修正したい人向けです。

前提条件

• Node.js 18+ バージョン
• macOS システム（macOS固有のクリップボード操作に依存しているため）

📦 インストール

以下の手順でインストールしてください。

npm install -g @kazuph/mcp-fetch

🔧 画像処理の仕様

画像処理には、最高のパフォーマンスと品質を得るためにSharpライブラリを使用しています。複数の画像が見つかった場合、サイズ制限を考慮して、順番に垂直方向に結合されます。

🔧 設定

~/.config/mcp-fetch.json に以下の設定を追加してください。

{
  "proxy": "http://your-proxy-server:port",
  "timeout": 30000,
  "maxConcurrency": 5
}

📚 利用可能なパラメータ

リクエストボディのパラメータ

基本パラメータ

高度なパラメータ

レスポンスボディのパラメータ

基本レスポンス

画像レスポンス

💻 使用例

基本的な使用法

{
  "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）
• disableImages パラメータを削除し、代わりに enableFetchImages パラメータを使用する

v1.1.0

• 記事タイトルの抽出機能を追加
• レスポンス形式を改善して、記事タイトルを含める
• MCPレスポンスコンテンツの型の問題を修正

v1.0.0

• 初期バージョンをリリース
• Webコンテンツの取得、画像処理と最適化、ページ分割サポートなどの機能を提供する