Fetch With Images

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

可用参数说明

请求体参数

基本参数

高级参数

响应体参数

基本响应

图像响应

💻 使用示例

基础用法

{
  "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 库以确保高性能和高质量；当发现多张图像时，它们会按顺序垂直拼接，并考虑尺寸限制；animated GIFs 会自动处理为提取其第一帧。

📈 变更日志

v1.1.3

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

v1.1.0

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

v1.0.0

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