🚀 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）所必需的。
✨ 主要特性
- 网页内容提取：可自动提取网页内容并将其格式化为 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 | string | 是 | 待抓取的网页地址 |
| enableFetchImages | bool | 否 | 是否启用图像处理，默认为 false |
| imageStartIndex | number | 否 | 图像起始索引，默认为 0 |
| imageMaxCount | number | 否 | 最大抓取图像数量，默认为 1 |
高级参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| proxy | string | 否 | 设置代理服务器地址和端口 |
| timeout | number | 否 | 设置请求超时时间，单位为毫秒，默认 30000 |
| maxConcurrency | number | 否 | 设置并发请求数量，默认为 5 |
响应体参数
基本响应
| 参数名 | 类型 | 描述 |
|---|---|---|
| content | string | 抓取到的网页内容 |
| title | string | 文章标题 |
| images | array | 抓取到的图像列表 |
图像响应
| 参数名 | 类型 | 描述 |
|---|---|---|
| src | string | 图像源地址 |
| width | number | 图像宽度 |
| height | number | 图像高度 |
| extractedFrame | bool | 是否为 GIF 的第一帧 |
💻 使用示例
基础用法
{
"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
- 初始版本发布。
- 提供网页内容抓取、图像处理和优化、分页支持等功能。