BT下载管理服务

Transmission MCP Server是一个基于Model Context Protocol(MCP)的服务器,为Transmission BitTorrent客户端提供全面的工具来管理种子、控制Transmission守护进程并通过标准化的MCP接口监控下载。

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

使用说明

传输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)