金大哥 - mcp-fetch MCP 详情

article

README

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

这样一来，如有需要，系统将自动下载并运行该工具的最新版本。

必要设置

启用 Claude 的辅助功能：
- 打开系统设置。
- 转到“隐私与安全”>“辅助功能”。
- 点击“+”按钮。
- 从您的应用程序文件夹中添加 Claude。
- 打开 Claude 的切换开关。

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

开发人员使用指南

以下部分适用于希望开发或修改该工具的人员。

先决条件

Node.js 18+
macOS（用于剪贴板操作）
Claude Desktop（从 https://claude.ai/desktop 安装）
tsx（通过 npm install -g tsx 安装）

安装

使用 Smithery 安装

要通过 Smithery 自动安装 MCP 抓取工具，可执行以下命令：

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

📦 图像处理规范

从网络内容抓取图像时，将应用以下限制：

每组最多 6 张图像。
每组最大高度为 8000 像素。
每组最大大小为 30MB。

若内容超过这些限制，图像将自动分成多个组，并且需要多次粘贴（Cmd + V）。

🛠️ 配置

确保 Claude Desktop 已安装并运行。
如果尚未安装，请全局安装 tsx：

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

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

您可以通过以下步骤轻松找到该文件：

打开 Claude Desktop。
点击菜单栏中的“Claude”。
点击“设置”。
点击“开发者”。

在 MCP 客户端配置中添加以下内容：

{
  "tools": {
    "fetch": {
      "args": ["tsx", "/path/to/mcp-fetch/index.ts"]
    }
  }
}

💻 可用工具

fetch：从互联网抓取 URL 并将其内容提取为 Markdown 格式。图像会自动处理并准备好进行剪贴板操作。

⚠️ 注意事项

⚠️ 重要提示

此工具专为 macOS 设计，因为其依赖于 macOS 特定的剪贴板操作。

💡 使用建议

图像使用 Sharp 进行处理，以实现最佳性能和质量。

当找到多个图像时，它们会被垂直合并，并考虑大小限制。

动态 GIF 会自动通过提取第一帧进行处理。

mcp-fetch