三步即可开始
选择你的 AI 客户端,按步骤接入 TorrentClaw。
安装 Node.js
确认系统已安装 Node.js 18 及以上版本。
写入配置
~/Library/Application Support/Claude/claude_desktop_config.json
重启并验证
重启 AI 客户端,你会看到 4 个新工具:search_torrents、get_stats、get_torrent_file、autocomplete。
{
"mcpServers": {
"torrentclaw": {
"command": "npx",
"args": ["-y", "@torrentclaw/mcp"],
"env": {
"BASE_URL": "https://herecomesaconsequence.com"
}
}
}
}4 个工具,一套协议
在任意 MCP 客户端里搜索、筛选并获取种子元数据。
search_torrents
搜索电影和剧集,支持多维筛选(类型、年份、画质、评分、语言)。
search_torrents({
q: "Big Buck Bunny",
quality: "1080p",
sort: "seeders"
})Found 5 torrents for "Big Buck Bunny" Best match: Big Buck Bunny (2008) Quality: 1080p • x264 • BluRay Size: 276 MB • Seeders: 312 Score: 78/100
get_stats
获取聚合器的实时数据(内容总量、资源来源、最近入库情况)。
get_stats()📊 TorrentClaw Statistics Movies: 72,845 | Shows: 18,234 Torrents: 1,247,392 Sources: YTS, EZTV, Knaben, Torrentio... Last update: 2 minutes ago
get_torrent_file
根据 info hash 生成 .torrent 文件的下载链接。
get_torrent_file(
"dd8255ecdc7ca55f..."
)✅ Torrent file URL generated https://herecomesaconsequence.com/api/v1/torrent/dd8255ecdc7ca55f... File: Big.Buck.Bunny.2008.1080p.BluRay.x264.torrent Ready to view
autocomplete
按热度排序,返回搜索联想建议。
autocomplete({
q: "big buck"
})💡 Suggestions: 1. Big Buck Bunny (2008) — Movie 2. Big Fish (2003) — Movie 3. Big Hero 6 (2014) — Movie 4. The Big Lebowski (1998) — Movie
你能用它做什么
通过真实示例,看看 MCP 服务器实际怎么用。
"Find the best quality torrent for Big Buck Bunny"
客户端兼容性
适配所有支持 MCP 的 AI 客户端和编辑器。
| 客户端 | Search Torrents | Get Statistics | Download Files | Autocomplete | 状态 |
|---|---|---|---|---|---|
Claude Desktop macOS, Windows | 稳定 | ||||
Cursor macOS, Windows, Linux | 稳定 | ||||
Windsurf macOS, Windows | 稳定 | ||||
Cline VS Code | 稳定 | ||||
Roo Code VS Code | 稳定 | ||||
OpenClaw CLI, Terminal | 稳定 | ||||
Continue VS Code, JetBrains | 测试版 | ||||
Open Code VS Code | 测试版 | ||||
Kilo Code macOS, Linux | 测试版 | ||||
Zed macOS, Linux | 即将支持 |
所有功能在稳定版客户端上表现一致。测试版客户端功能可能有限;即将支持的客户端正在开发 MCP 支持。
支持的平台
常见问题解答
关于 TorrentClaw MCP 服务器,你想知道的都在这里。
模型上下文协议(MCP)是一套开放标准,能让 AI 助手接入外部工具和数据源。它由 Anthropic 提出,已被 Claude Desktop、Cursor、Windsurf 等 AI 客户端支持。
借助 MCP,你可以把 AI 助手接到各类 API、数据库和服务上,比如 TorrentClaw,从而大幅扩展它的能力。
目前支持 MCP 的有 Claude Desktop、Cursor、Windsurf、Cline(VS Code 插件)以及 Continue(测试版),还有更多客户端正在陆续接入。
完整的支持列表和状态,请查看上方的兼容性对照表。
免费!TorrentClaw MCP 服务器完全免费且开源,没有使用次数限制,无需 API 密钥,也没有付费档位。
herecomesaconsequence.com 的公开 API 同样免费,仅有合理的调用频率限制。
可以。TorrentClaw 完全开源(Apache 2.0 许可)。你可以克隆代码仓库、部署自己的实例,并通过设置 BASE_URL 环境变量,把 MCP 服务器指向你自己的 API。
安装说明详见 GitHub 代码仓库。
公开 API 设有合理的频率限制以防滥用。正常使用(每分钟几次搜索)完全不会触及上限。
如果你需要更高的额度,可以考虑自建部署,或联系我们定制方案。
常见原因:
1. Node.js 版本:确认已安装 Node.js 18 或更高版本。
2. 需要重启:写入 MCP 配置后,必须彻底重启 AI 客户端。
3. 查看日志:检查客户端的 MCP 日志排查报错。在 Claude Desktop 中,可以在开发者工具里找到日志。
4. 防火墙:确认防火墙允许对 herecomesaconsequence.com 的出站连接。
