aria2 MCP服务器
特性
- 下载管理：添加、暂停、恢复和删除下载
- 状态监测：获取实时下载状态和进度
- 批量操作：列出活动、等待和停止的下载
- 全球统计：查看整体下载/上传速度
- 选项控制：动态更改下载选项
- 多协议支持：HTTP/HTTPS、FTP/SFTP、BitTorrent、磁力链接
安装
先决条件
- Node.js 18或更高版本
- 咏叹调2 在启用RPC和WebSocket支持的情况下运行
使用WebSocket RPC启动aria2：
# With RPC secret (recommended)
aria2c --enable-rpc --rpc-listen-all=true --rpc-allow-origin-all \
--rpc-secret=your_secret_token \
--rpc-listen-port=6800
# The RPC URL will be: ws://localhost:6800/jsonrpc安装MCP服务器：
cd /path/to/aira2-mcp
npm install配置
环境变量
| 变量 | 描述 | 默认值 | 必填 |
|---|---|---|---|
ARIA2_RPC_URL | aria2 RPC WebSocket URL | ws://localhost:6800/jsonrpc | 是的 |
ARIA2_RPC_SECRET | 用于身份验证的RPC秘密令牌 | None | 是 |
ARIA2_TIMEOUT | 请求超时（秒） | 30 | 没有 |
重要:
ARIA2_RPC_URL必须使用WebSocket协议(ws://或wss://)ARIA2_RPC_SECRET是 必需的 如果aria2配置了--rpc-secret
与Claude Desktop集成
添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"aria2": {
"command": "node",
"args": ["/path/to/aira2-mcp/src/index.js"],
"env": {
"ARIA2_RPC_URL": "ws://localhost:6800/jsonrpc",
"ARIA2_RPC_SECRET": "your_secret_token_here"
}
}
}
}可用工具
| 工具 | 说明 |
|---|---|
add_download | 从URL添加新的下载 |
add_torrent_download | 添加BitTorrent下载 |
get_download_status | 获取特定下载的状态 |
list_active_downloads | 列出所有活动下载 |
list_waiting_downloads | 列出队列中的下载 |
list_stopped_downloads | 列出已完成/失败的下载 |
pause_download | 暂停特定下载 |
resume_download | 恢复暂停的下载 |
remove_download | 删除/删除下载 |
pause_all_downloads | 暂停所有活动下载 |
resume_all_downloads | 恢复所有暂停的下载 |
get_global_stats | 获取全球下载统计数据 |
purge_stopped_downloads | 清除已停止的下载历史记录 |
get_version | 获取aria2版本信息 |
get_download_options | 获取下载选项 |
change_download_options | 更改下载选项 |
用法示例
添加下载
Please download this file: https://example.com/file.zip检查下载状态
What's the status of download with GID 1234567890abcdef?列表下载
Show me all active downloads暂停和恢复
Pause the download with GID 1234567890abcdef带选项下载
Download https://example.com/largefile.zip and save it to /Downloads folder发展
使用MCP检查器运行
mcp dev src/index.js直接运行
npm start建筑
aira2-mcp/
├── src/
│ └── index.js # MCP server implementation
├── package.json # Project configuration
└── README.md # This file许可证
麻省理工学院
贡献
欢迎投稿！请随时提交拉取请求。