Claude代码的快速WebFetch MCP服务器
一个高性能的MCP服务器,用于使用带有自动回退功能的Firecrawl后端在Claude Code中进行web获取。
特性
| 工具 | 说明 |
|---|---|
fast_fetch | 获取URL,提取内容,返回markdown |
fast_fetch_raw | 返回未经处理的原始HTML |
fast_fetch_json | 获取并解析JSON端点 |
fast_fetch_multiple | 并行获取多个URL |
运作原理
- 主要的,重要的 使用Firecrawl API进行JS渲染和注释提取
- 退路: 如果Firecrawl不可用,则使用直接获取+Mozilla可读性
- AI总结: 通过本地LLM API进行可选摘要
URL -> Try Firecrawl -> Success? -> AI Summary (optional) -> Result
|
v (failed/unavailable)
Direct Fetch + Readability -> AI Summary (optional) -> Resultfast_fetch参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
url | string | 必填 | 要获取的URL |
prompt | string | - | AI摘要提示 |
max_length | number | 10000 | 最大内容长度(字符) |
include_links | boolean | true | 在输出中包含超链接 |
no_summarize | boolean | false | 即使有提示也跳过AI摘要 |
快速安装
使用Claude CLI(推荐)
# Clone the repo
git clone https://github.com/nikketryhard/fast-webfetch-mcp.git ~/fast-webfetch-mcp
# Install dependencies
cd ~/fast-webfetch-mcp && bun install
# Add MCP server with environment variables
claude mcp add fast-webfetch \
-e FIRECRAWL_API_URL=http://localhost:3002 \
-e FAST_WEBFETCH_API_URL=http://127.0.0.1:8045/v1 \
-e FAST_WEBFETCH_MODEL=gemini-3-flash \
-e FAST_WEBFETCH_API_KEY=your_api_key_here \
-e FAST_WEBFETCH_USE_RUST=1 \
-e FAST_WEBFETCH_RUST_BIN=/home/YOUR_USERNAME/fast-webfetch-mcp/rust/target/release/fast-webfetch-mcp-rs \
-- bun run ~/fast-webfetch-mcp/src/index.ts
# Or minimal (uses defaults)
claude mcp add fast-webfetch -- bun run ~/fast-webfetch-mcp/src/index.ts手动安装
# Clone the repo
git clone https://github.com/nikketryhard/fast-webfetch-mcp.git ~/fast-webfetch-mcp
# Install dependencies
cd ~/fast-webfetch-mcp && bun install然后添加到 ~/.claude.json:
{
"mcpServers": {
"fast-webfetch": {
"command": "bun",
"args": ["run", "/home/YOUR_USERNAME/fast-webfetch-mcp/src/index.ts"],
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FAST_WEBFETCH_API_URL": "http://127.0.0.1:8045/v1",
"FAST_WEBFETCH_MODEL": "gemini-3-flash",
"FAST_WEBFETCH_API_KEY": "your_api_key_here",
"FAST_WEBFETCH_USE_RUST": "1",
"FAST_WEBFETCH_RUST_BIN": "/home/YOUR_USERNAME/fast-webfetch-mcp/rust/target/release/fast-webfetch-mcp-rs"
}
}
}
}环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
FIRECRAWL_API_URL | http://localhost:3002 | Firecrawl API终结点 |
FAST_WEBFETCH_API_URL | http://127.0.0.1:8045/v1 | 用于摘要的OpenAI兼容API |
FAST_WEBFETCH_MODEL | gemini-3-flash | 摘要模型名称 |
FAST_WEBFETCH_API_KEY | _(空)_ | 摘要终结点的API密钥 |
FAST_WEBFETCH_USE_RUST | 0 | 启用Rust后端工作路径 |
FAST_WEBFETCH_RUST_BIN | _(空)_ | Rust二进制文件的绝对路径 |
Firecrawl设置(可选但推荐)
为了获得最佳效果(JS渲染、注释提取),请在本地运行Firecrawl:
# Using Docker
docker run -p 3002:3002 mendableai/firecrawl
# Or use the official Firecrawl MCP
claude mcp add firecrawl-mcp -e FIRECRAWL_API_URL=http://localhost:3002 -- npx -y firecrawl-mcp如果没有Firecrawl,服务器将退回到直接获取+可读性(无JS渲染)。
与原生WebFetch的比较
| 功能 | 本机WebFetch | 快速WebFetch |
|---|---|---|
| Reddit/推特 | 被屏蔽(403) | 有效 |
| 用户代理 | 克劳德用户(已阻止) | 真实浏览器UA |
| JS渲染 | 否 | 是(使用Firecrawl) |
| 评论 | 否 | 是(使用Firecrawl) |
| 内容 | 俳句总结 | 全降价 |
| AI总结 | Haiku 3.5 | 可配置模型 |
| 最大长度 | 100KB | 可配置 |
| 原始HTML | 否 | 是 |
| JSON获取 | 否 | 是 |
| 并行获取 | 否 | 是 |
| 回退 | 无 | 直接获取 |
需求
- 包子 运行时
- 克劳德代码2.0+
- (可选)用于JS渲染的Firecrawl
- (可选)用于摘要的兼容OpenAI的API
许可证
麻省理工学院
贡献
PR欢迎!请先打开一个问题来讨论更改。
