AI导哈

下载管理协议服务器

aria2 MCP服务器是一个为aria2下载管理器提供标准化接口的服务，允许AI助手通过MCP协议与aria2交互，实现下载管理、状态监控和多协议支持。

  • by kinmeic
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kinmeic/aria2-mcp

使用说明

aria2 MCP服务器

A. 模型上下文协议（MCP） 服务器 咏叹调2 下载管理器。该服务器允许AI助手通过标准化的界面与aria2进行交互。

特性

  • 下载管理：添加、暂停、恢复和删除下载
  • 状态监测：获取实时下载状态和进度
  • 批量操作：列出活动、等待和停止的下载
  • 全球统计：查看整体下载/上传速度
  • 选项控制：动态更改下载选项
  • 多协议支持：HTTP/HTTPS、FTP/SFTP、BitTorrent、磁力链接

安装

先决条件

  1. Node.js 18或更高版本
  2. 咏叹调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

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

参考文献

相关 MCP