🚀 MCP 抓取工具

MCP（Model Context Protocol）抓取工具可用于抓取网络内容并处理图像。借助该工具，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；
   • 启用 Claude 旁边的切换开关。

此辅助功能设置是自动执行剪贴板操作（Cmd + V）所必需的。

✨ 主要特性

• 网页内容提取：自动提取网页内容，并将其格式化为 Markdown。
• 文章标题提取：提取并显示文章标题。
• 图像处理：可选择处理网络页面中的图像，具备优化功能（默认关闭，若要启用，请设置 enableFetchImages: true）。
• 分页支持：支持文本和图像的分页。
• JPEG 优化：自动将图像转换为 JPEG 格式，并可控制质量。
• GIF 支持：提取 animated GIFs 的第一帧。

📦 安装指南

先决条件

• 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
}

可用参数

请求体参数

基本参数

高级参数

响应体参数

基本响应

图像响应

💻 使用示例

示例 1：基本使用

{
  "url": "https://example.com"
}

示例 2：启用图像抓取

{
  "url": "https://example.com",
  "enableFetchImages": true,
  "imageMaxCount": 3
}

示例 3：分页抓取图像

{
  "url": "https://example.com",
  "enableFetchImages": true,
  "imageStartIndex": 3,
  "imageMaxCount": 3
}

📚 详细文档

备注

• 此工具专为 macOS 设计，因为它依赖 macOS 特定的剪贴板操作。
• 图像处理使用 Sharp 库，以确保高性能和高质量。
• 当发现多张图像时，它们会按顺序垂直拼接，并考虑尺寸限制。
• animated GIFs 会自动处理为提取其第一帧。

变更日志

v1.1.3

• 修改默认行为：默认不抓取图像（enableFetchImages: false）；
• 移除 disableImages 参数，转而使用 enableFetchImages 参数。

v1.1.0

• 新增文章标题提取功能；
• 改进响应格式以包含文章标题；
• 修复 MCP 响应内容中的类型问题。

v1.0.0

• 初始版本发布；
• 提供网页内容抓取、图像处理和优化、分页支持等功能。