MCP URL 下载器
一个模型上下文协议(MCP)服务器,使AI助手能够从URL下载文件到本地文件系统。
特点/特性
- 从URL下载单个或多个文件,支持并发下载
- 文件大小验证(可配置,默认500MB)
- 生成唯一文件名以防止覆盖
- 安全
安装
# Using uvx (recommended)
uvx mcp-url-downloader
# Using pip
pip install mcp-url-downloader
# From source
git clone https://github.com/dmitryglhf/mcp-url-downloader.git
cd mcp-url-downloader
uv sync配置
Claude Desktop(可译为“克劳德桌面版”或根据具体语境简化为“克劳德桌面”)
要将服务器与Claude集成,请将以下内容添加到您的 claude_desktop_config.json 文件:
{
"mcpServers": {
"url-downloader": {
"command": "uvx",
"args": ["mcp-url-downloader"]
}
}
}工具
download_single_file
从URL下载单个文件,可选自定义文件名。
参数:
url(字符串,必填):要下载的文件的URL
- 必须是有效的HTTP/HTTPS URL - 最大长度:2048个字符
output_dir(字符串,可选):保存文件的目录
- 默认值: ~/Downloads/mcp-downloads/ - 必须是一个有效的可写目录路径
filename(字符串,可选):保存文件时使用的自定义文件名
- 如果未提供,则从URL中提取 - 将自动进行消毒 - 扩展将被保留或检测到
timeout(数字,可选):下载超时时间(以秒为单位)
- 默认: 60 - 范围: 1-300
max_size_mb(数字,可选):文件最大大小(MB)
- 默认: 500 - 范围: 1-5000
download_files
并发地从多个URL下载文件。
参数:
urls(字符串数组,必填):要下载的URL列表
- 每个URL必须是有效的HTTP/HTTPS - 最大值:每次请求100个URL - 每个URL的最大长度:2048个字符
output_dir(字符串,可选):保存所有文件的目录
- 默认: ~/Downloads/mcp-downloads/ - 所有文件都将保存到此目录
timeout(数字,可选):每个文件的下载超时时间(以秒为单位)
- 默认值: 60 - 范围: 1-300
max_size_mb(数字,可选):每个文件的最大大小(以MB为单位)
- 默认值: 500 - 范围: 1-5000
速率限制
- 每最多100个URL
download_files请求 - 最大并发下载数:10(可配置至最高50)
- URL长度限制为2048个字符
- 超时范围:1-300秒
- 文件大小范围:1-5000 MB
发展
# Run tests
uv run pytest