MCP Fetch

用于获取网页内容和处理图像的模型上下文协议服务器。这允许 Claude Desktop（或任何 MCP 客户端）适当地获取网页内容和处理图像。

<a href="https://glama.ai/mcp/servers/5mknfdhyrg"><img width="380" height="200" src="https://glama.ai/mcp/servers/5mknfdhyrg/badge" alt="@kazuph/mcp-fetch MCP server" /></a>

快速开始（用户）

要将此工具与 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 支持：提取动画 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

图像处理规范

处理网页内容中的图像时，将应用以下优化：

• 图像转换为具有质量控制的 JPEG 格式
• 默认最大宽度限制为 1200px
• 默认最大高度限制为 1600px
• 色度子采样 (4:2:0) 以获得更好的压缩
• MozJPEG 优化以获得更小的文件大小

配置

1. 确保 Claude Desktop 已安装并正在运行。

2. 如果您还没有全局安装 tsx：

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

3. 修改您的 Claude Desktop 配置文件，该文件位于： ~/Library/Application Support/Claude/claude_desktop_config.json

您可以通过 Claude Desktop 菜单轻松找到它：

1. 打开 Claude Desktop
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）：返回原始内容而不是处理后的 markdown
• 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)
• 删除了 disableImages，改为使用 enableFetchImages 参数

v1.1.0

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

v1.0.0

• 初始版本
• 网页内容提取
• 图像处理和优化
• 分页支持