使用说明
传输MCP服务器
适用于Transmission BitTorrent客户端的模型上下文协议(MCP)服务器。此服务器提供了全面的工具来管理种子文件、控制Transmission守护进程,并通过标准化的MCP接口监控下载任务。
特点/特性
- Torrent 管理添加、删除、暂停、恢复和验证种子文件
- 队列控制管理下载队列顺序
- 会话管理配置Transmission守护进程设置
- 实时监控获取种子状态、统计数据和进度
- 文件操作移动种子文件,检查可用空间
- 灵活输出支持人类可读的Markdown格式和机器可读的JSON格式
先决条件
- Node.js 18 或更高版本
- 本地或远程运行的传输守护进程
- 传输RPC凭据(如果启用了身份验证)
安装
npm install
npm run build
配置
服务器需要通过环境变量获取Transmission守护进程的连接详情:
TRANSMISSION_URL- Transmission RPC 的基本 URL(默认:http://localhost:9091)TRANSMISSION_USERNAME- 用于认证的用户名(可选)TRANSMISSION_PASSWORD- 用于身份验证的密码(可选)
示例:
export TRANSMISSION_URL="http://localhost:9091"
export TRANSMISSION_USERNAME="admin"
export TRANSMISSION_PASSWORD="password"
使用方法
使用Claude Desktop
在您的Claude桌面配置中添加:
MacOS(苹果电脑操作系统): ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"transmission": {
"command": "node",
"args": ["/path/to/transmission-mcp/dist/index.js"],
"env": {
"TRANSMISSION_URL": "http://localhost:9091",
"TRANSMISSION_USERNAME": "your-username",
"TRANSMISSION_PASSWORD": "your-password"
}
}
}
}
独立的
npm start
可用工具
Torrent管理
transmission_add_torrent- 从磁力链接URI、URL或base64编码的.torrent文件添加种子transmission_list_torrents- 列出所有种子文件,并可选择性过滤transmission_get_torrent- 获取特定种子文件的详细信息transmission_remove_torrent- 移除种子文件,并可选择删除本地文件transmission_pause_torrent- 暂停活跃的种子文件(或:暂停正在下载的种子)transmission_resume_torrent- 恢复暂停的种子(torrent)transmission_verify_torrent- 验证种子数据的完整性transmission_reannounce_torrent- 力量追踪器重新发布transmission_move_torrent- 将种子文件移动到新位置transmission_set_torrent- 更新种子设置(标签、优先级、限制)
排队管理
transmission_queue_move- 在下载队列中移动种子文件(顶部/上移/下移/底部)
会话管理
transmission_get_session- 获取Transmission守护进程配置transmission_set_session- 更新守护进程设置transmission_get_stats- 获取会话统计信息(当前和累计)
实用程序
transmission_free_space- 检查可用磁盘空间
发展
# Install dependencies
npm install
# Run in development mode with auto-reload
npm run dev
# Build the project
npm run build
# Clean build artifacts
npm run clean
许可证
麻省理工学院(MIT)