传输客户端MCP
一个MCP服务器，它公开 传输 BitTorrent客户端控件作为工具，允许AI助手代表您管理种子。
MCP（模型上下文协议） 是一个开放标准，允许AI助手调用外部工具和服务。此服务器通过HTTP/SSE实现MCP，因此任何兼容MCP的AI应用程序都可以控制您的传输实例。
______________________________________________________________________
先决条件
- 传输 --在您的网络上运行和访问
- 码头工人 --对于Docker Compose部署路径
- 紫外线 --有关源部署路径（请参见 安装uv)
______________________________________________________________________
快速开始
选项A——Docker编写
- 创建一个
docker-compose.yml:
services:
transmission-mcp:
image: sesopenko/transmission_client_mcp:latest
ports:
- "8080:8080"
volumes:
- ./config.toml:/config/config.toml:ro
restart: unless-stopped- 复制示例配置并对其进行编辑：
cp config.toml.example config.toml- 启动服务器：
docker compose up -d选项B——从源运行
- 安装 紫外线 如果你还没有。
- 安装依赖项：
uv sync- 复制示例配置并对其进行编辑：
cp config.toml.example config.toml- 启动服务器：
uv run python -m transmission_mcp______________________________________________________________________
配置
创建一个 config.toml 在工作目录中（或传递 --config ):
[transmission]
host = "localhost"
port = 9091
username = "transmission"
password = "password"
[server]
host = "0.0.0.0"
port = 8080
[logging]
level = "info"______________________________________________________________________
连接AI应用程序
将兼容MCP的AI应用程序指向服务器的MCP端点：
http://:
/mcp例如，如果服务器正在运行 192.168.1.10 使用默认端口：
http://192.168.1.10:8080/mcp有关如何注册MCP服务器，请参阅您的AI应用程序的文档。
______________________________________________________________________
系统提示示例
复制并调整此系统提示，为您的AI助手提供有关使用传输工具的明确指导。
You are a home network download manager specialising in BitTorrent. Your
expertise covers torrent lifecycle management — queuing, monitoring progress,
organising downloads, and cleaning up completed or unwanted transfers. You
have direct control of a Transmission instance via MCP tools.
List all torrents, sorted by date added (oldest first).
Queue a torrent for addition by magnet link or HTTP/HTTPS URL (asynchronous).
List all torrent additions currently waiting in the queue.
Get detailed information about a torrent by name.
List the files contained in a torrent by name.
Start or resume a paused torrent by name.
Stop or pause an active torrent by name.
Remove a torrent by name, keeping data on disk.
Remove a torrent and permanently delete all downloaded data.
When the user asks about downloads, call list_torrents first for an overview, then get_torrent for details on a specific item.
To add torrents, use add_torrent to queue them, then use list_queued_additions to check queue status.
To view the files in a torrent, call list_files_for_torrent after identifying the torrent with get_torrent.
Before calling remove_torrent or remove_torrent_and_delete_data, confirm the torrent name with the user.
Before calling remove_torrent_and_delete_data, explicitly warn the user that all downloaded data will be permanently deleted and require unambiguous confirmation before proceeding.
Prefer stop_torrent over removal when the user only wants to pause activity.
______________________________________________________________________
可用工具
| 工具 | 说明 |
|---|---|
list_torrents | 列出由Transmission管理的所有种子，按添加日期排序（最旧的优先）。 |
add_torrent | 通过磁力链接或HTTP/HTTPS URL（异步，具有限制以防止跟踪器速率限制）排队添加种子。 |
list_queued_additions | 列出当前在队列中等待的所有种子添加。 |
get_torrent | 按名称获取单个种子的详细信息，包括保存路径、比率和错误状态。 |
list_files_for_torrent | 列出torrent中包含的文件，按名称标识。 |
start_torrent | 按名称启动或恢复暂停的种子。 |
stop_torrent | 按名称停止或暂停活动的种子。 |
remove_torrent | 按名称删除种子，将所有下载的数据保存在磁盘上。 |
remove_torrent_and_delete_data | 按名称删除种子并永久删除所有下载的数据。 |
工具在实施过程中记录在此处。
______________________________________________________________________
安全
此服务器具有 无需认证 在其MCP端点上。它仅设计用于局域网。
请勿将此服务器直接暴露于互联网。
如果您需要远程访问它，请将其放置在处理TLS终止和访问控制的反向代理后面。配置反向代理不在此项目范围内。
______________________________________________________________________
贡献/维护
看 维护.md 了解设置、开发命令以及如何运行测试。
______________________________________________________________________
许可证
版权所有（c）Sean Esopenko 2026
该项目根据 GNU通用公共许可证v3.0.
______________________________________________________________________
致谢：骑在巨人的背上
这个项目是在 克劳德代码，由Anthropic开发的AI编码助手。
像Claude这样的人工智能助手接受了大量数据的培训，其中大部分是由开源社区编写的：开发人员自由贡献的库、工具、文档和数十年的共享知识。没有这个基础，这样的工具是不可能的。
鉴于该债务，该项目根据 GNU通用公共许可证v3.0GPL确保此代码以及任何衍生作品保持开源。这是一个小小的互惠行为：回馈公地，使之成为可能。
对于每一位将提交推送到公共仓库、编写Stack Overflow答案或在开放许可证下发布包的开发人员——谢谢。