README
🚀 MCP 抓取工具
MCP 抓取工具是一个用于抓取网页内容并处理图像的模型上下文协议(Model Context Protocol)服务器。它允许 Claude Desktop(或其他 MCP 客户端)抓取网络内容,并对图像进行适当处理。
🚀 快速开始
面向用户
要在 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 库进行处理,以实现性能和质量的优化。
- 当找到多张图像时,它们会垂直排列成一组,每组最多 6 张,并自动调整大小以适应屏幕。
- 对于 GIF 动图,只会提取第一帧进行处理。
Scan to contact