使用说明
CloudScraper MCP服务器
模型上下文协议服务器,使AI代理能够绕过Cloudflare保护并抓取web内容
快速开始
克隆存储库并安装依赖项:
git clone https://github.com/yourusername/cloudscraper-mcp-server.git
cd cloudscraper-mcp-server
uv sync
添加到克劳德代码:
claude mcp add cloudscraper-mcp \
--type stdio \
--command "uv" \
--args "run" "server.py" \
--directory "/path/to/cloudscraper-mcp-server"
添加到VSCode/任何兼容MCP的IDE:
{
"mcpServers": {
"cloudscraper-mcp": {
"type": "stdio",
"command": "uv",
"args": ["run", "server.py"],
"cwd": "/path/to/cloudscraper-mcp-server"
}
}
}
特性
- Cloudflare旁路 --自动处理Cloudflare保护,以便AI代理可以访问阻止标准请求的页面
- 内容物清理 --将HTML转换为干净、LLM友好的Markdown
- 智能分块 --自动将大型响应拆分为带有连续令牌的10k个令牌块
- 二进制处理 --Base64对非文本内容进行编码,以便代理可以处理图像和下载
- 文件导出 --通过以下方式将抓取的内容直接保存到磁盘
scrape_url_to_file - Docker支持 --通过以下方式进行容器化部署 医生.md
有三种工具可供选择: scrape_url (以字符串形式返回内容), scrape_url_raw (返回内容加上响应元数据),以及 scrape_url_to_file (将内容保存到磁盘)。
配置
传输协议
| 运输 | 最适合 | 配置 |
|---|---|---|
| 标准 | Claude Code、VSCode、直接AI集成 | 默认模式,不需要环境变量 |
| 超文本传输协议 | n8n,Web应用程序,API集成,远程访问 | 需要 MCP_TRANSPORT=http |
使用HTTP传输运行:
MCP_TRANSPORT=http MCP_HOST=0.0.0.0 MCP_PORT=8000 uv run server.py
环境变量
| 变量 | 默认值 | 选项 | 描述 |
|---|---|---|---|
MCP_TRANSPORT |
stdio | stdio,http | 传输协议选择 |
MCP_HOST |
0.0.0.0 | 任何有效的IP | HTTP模式的主机绑定 |
MCP_PORT |
8000 | 任何有效端口 | HTTP模式端口 |