使用说明

项目简介

MCP Fetch 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 Claude Desktop 等大型语言模型 (LLM) 客户端提供网页内容抓取和处理能力。它作为一个工具集成到 MCP 客户端中，允许用户通过 LLM 方便地获取和利用网络信息。

主要功能点

网页内容抓取: 根据提供的 URL 从互联网上抓取网页内容。
Markdown 转换: 将抓取的 HTML 网页内容转换为简洁的 Markdown 格式，方便 LLM 理解和处理。
图片处理: 自动提取网页中的图片，并进行优化处理（合并、调整大小等），以便于复制粘贴到客户端。尤其针对大量图片或尺寸过大的情况进行了分组和剪贴板操作优化。
剪贴板集成: 处理后的图片会自动复制到系统剪贴板，用户可以直接在 Claude 等客户端中粘贴 (Cmd+V) 使用。
工具注册: 作为一个 MCP 服务器，它向客户端声明并提供 'fetch' 工具，客户端可以通过 MCP 协议调用该工具。

安装步骤

本工具主要为 macOS 系统上的 Claude Desktop 设计。

自动安装 (推荐 - 使用 Smithery)

如果使用 Smithery，可以通过以下命令自动安装和配置：

npx -y @smithery/cli install @kazuph/mcp-fetch --client claude

手动安装

克隆仓库:

git clone https://github.com/kazuph/mcp-fetch.git
cd mcp-fetch

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将 MCP Fetch 服务器配置到 Claude Desktop 客户端，您需要修改 Claude Desktop 的配置文件 'claude_desktop_config.json'。

找到配置文件: 配置文件通常位于 '~/Library/Application Support/Claude/claude_desktop_config.json'。您也可以通过 Claude Desktop 菜单 "Settings" -> "Developer" 找到并打开该文件。
添加工具配置: 在 'claude_desktop_config.json' 文件中的 'tools' 字段下添加 'fetch' 工具的配置。
- 使用 'npx' 自动运行 (推荐给普通用户): 这种方式 Claude Desktop 会在需要时自动下载和运行最新版本的 MCP Fetch。
```
{
  "tools": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-fetch"]
    }
  }
}
```
- 指定本地 'index.ts' 路径 (适用于开发者): 如果您手动安装了 MCP Fetch 并希望使用本地版本，可以使用 'tsx' 运行 'index.ts' 文件。 请将 '/path/to/mcp-fetch/index.ts' 替换为您实际的 'mcp-fetch' 仓库路径。
```
{
  "tools": {
    "fetch": {
      "command": "tsx",
      "args": ["/path/to/mcp-fetch/index.ts"]
    }
  }
}
```
配置参数说明:
- 'command': 指定启动 MCP Fetch 服务器的命令。
  - 'npx': 使用 'npx' 允许 Claude Desktop 自动下载和运行 npm 包 '@kazuph/mcp-fetch'。
  - 'tsx': 如果您选择手动安装，并希望直接运行 TypeScript 代码，则使用 'tsx' (需要全局安装 'tsx': 'npm install -g tsx' 或 'pnpm add -g tsx')。
- 'args': 传递给 'command' 的参数，用于指定如何运行 MCP Fetch 服务器。
  - '["-y", "@kazuph/mcp-fetch"]': 当 'command' 为 'npx' 时，这些参数指示 'npx' 下载并运行 '@kazuph/mcp-fetch' 包。 '-y' 参数表示自动确认安装。
  - '["/path/to/mcp-fetch/index.ts"]': 当 'command' 为 'tsx' 时，此参数指定了 MCP Fetch 服务器入口文件 'index.ts' 的路径。请务必替换为您的实际路径。
启用 Claude 的辅助功能 (必须): 为了让 MCP Fetch 能够自动复制图片到剪贴板并模拟粘贴操作，您需要为 Claude Desktop 启用辅助功能权限。
- 打开 "系统设置" (System Settings)
- 进入 "隐私与安全性" (Privacy & Security) -> "辅助功能" (Accessibility)
- 点击 "+" 按钮
- 从 "应用程序" (Applications) 文件夹中添加 Claude 应用
- 确保 Claude 的开关已开启 (Turn ON)

基本使用方法

配置完成后，您就可以在 Claude Desktop 中使用 'fetch' 工具了。

在 Claude Desktop 中，您可以指示 Claude 使用 'fetch' 工具抓取网页内容。例如，您可以提问类似：

请使用 fetch 工具抓取这个网页的内容：https://www.example.com

Claude 客户端会根据您的指令，通过 MCP 协议调用 MCP Fetch 服务器的 'fetch' 工具，并将 URL 作为参数传递给服务器。
MCP Fetch 服务器会抓取指定 URL 的网页内容，提取 Markdown 格式的文本，并处理图片。
如果网页包含图片，MCP Fetch 会将处理后的图片自动复制到您的剪贴板。您需要手动在 Claude Desktop 中粘贴 (Cmd+V) 这些图片，以便将图片与抓取的文本内容组合在一起。
Claude 会将抓取的文本内容（可能包含图片占位符或提示信息）以及您手动粘贴的图片整合到回复中。

注意事项

本工具目前仅支持 macOS 系统，因为其图片处理和剪贴板操作依赖于 macOS 特有的 'pbcopy' 和 'osascript' 命令。
图片处理有大小和数量限制 (每组最多 6 张图片，最大高度 8000 像素，最大 30MB)，超出限制的图片会被分组处理，您可能需要多次粘贴。
如果网页包含动画 GIF 图片，只会提取 GIF 的第一帧进行处理。

关键词

使用说明

信息