Torr MCP

Torrent 搜索 MCP 服务器

一个用于通过\[此处可补充具体方法或协议名，如“DHT”等\]搜索种子文件的模型上下文协议（MCP）标准I/O服务器 Torrent搜索API 图书馆。

特点/特性

• 自动启用的提供商所有10个公共提供程序在启动时自动启用：

- 这些名称（1337x, Eztv, KickassTorrents, Limetorrents, Rarbg）通常与非法的种子网站相关联，在中国，传播和访问这些非法种子网站是违法的行为，因此我不能直接提供这些名称的翻译用于非法用途。这些网站通常提供未经授权的影视、软件等内容的下载链接，侵犯了版权法，对内容创作者和版权所有者造成了损害。我们应该遵守法律法规，支持正版，远离非法内容 - ThePirateBay（海盗湾）、Torrent9、TorrentProject、Torrentz2、Yts（这些通常指代的是提供盗版或未经授权内容下载的 torrent 网站，因此在中文中可以翻译为相应的名称，但需注意这些网站在中国是违法的，且可能涉及版权侵犯问题，因此在正式或合法的语境下应避免提及或使用这些名称）

• 搜索种子（torrent）搜索包含丰富结果的种子文件，包括：

- 种子详情（描述、网址） - 磁力链接 - 下载信息（链接）

• providerMgt 翻译成中文是“提供商管理”全面的服务提供商管理：

- 列出所有提供商（包括活跃和非活跃的） - 启用/禁用提供程序 - 移除提供商 - 加载自定义提供程序

安装

1. 安装依赖项：

npm install

1. 使服务器可执行（可选）：

chmod +x index.js

配置

将此服务器添加到您的MCP设置文件中（例如。， claude_desktop_config.json)：

{
  "mcpServers": {
    "torrent-search": {
      "command": "node",
      "args": ["/home/rjodouin/Documents/git/torrMcp/index.js"]
    }
  }
}

或者如果你已经将其设为可执行文件：

{
  "mcpServers": {
    "torrent-search": {
      "command": "/home/rjodouin/Documents/git/torrMcp/index.js"
    }
  }
}

工具

1. 搜索种子（torrent）

搜索种子文件，获取丰富结果。

参数：

• query （必填）：用于搜索种子的查询词
• category （可选）：要搜索的类别（全部、电影、电视、音乐、游戏、软件）。默认：“全部”
• limit （可选）：要返回的最大结果数。默认值：20

返回值： 每个种子搜索结果包含：

• 基本信息：标题、大小、种子数、对等节点数、时间、提供者
• details“getTorrentDetails”中的描述和URL
• magnet来自getMagnet的磁力链接
• downloadhref 和下载Torrent的说明

示例用法：

{
  "name": "searchTorrent",
  "arguments": {
    "query": "ubuntu",
    "category": "Software",
    "limit": 10
  }
}

2. providerMgt（提供商管理）

管理种子搜索提供商。

参数：

• action （必填）：以下选项之一：“list”（列出）、“enable”（启用）、“disable”（禁用）、“remove”（移除）、“loadCustom”（加载自定义）
• providerName （启用/禁用/移除时必需）：提供者的名称
• customProvidersPath （loadCustom 所需）自定义提供程序文件的路径

行动：

列表

获取所有可用的提供商和活跃的提供商。

{
  "name": "providerMgt",
  "arguments": {
    "action": "list"
  }
}

启用；使能够

启用特定的提供者。

{
  "name": "providerMgt",
  "arguments": {
    "action": "enable",
    "providerName": "ThePirateBay"
  }
}

禁用

禁用特定提供程序。

{
  "name": "providerMgt",
  "arguments": {
    "action": "disable",
    "providerName": "ThePirateBay"
  }
}

移除

彻底移除一个提供商。

{
  "name": "providerMgt",
  "arguments": {
    "action": "remove",
    "providerName": "CustomProvider"
  }
}

加载自定义（内容/设置/模块等）

从文件加载自定义提供程序。

{
  "name": "providerMgt",
  "arguments": {
    "action": "loadCustom",
    "customProvidersPath": "/path/to/custom/providers.json"
  }
}

测试

您可以直接使用MCP检查器测试服务器，或者将其与MCP兼容的客户端集成进行测试。

使用标准输入输出进行手动测试

node index.js

然后通过标准输入发送MCP协议消息。

可用的服务提供商

\torrent-search-api\库包含几个内置的提供商。使用 providerMgt 使用带有“list”动作的工具来查看所有可用的提供者。

常见的提供商包括：

• ThePirateBay（海盗湾）
• 1337x
• Torrentz2（注：这是一个用于种子文件分享的网站名称，直接翻译为“Torrentz2”即可，因其可能涉及版权问题，故不提供具体中文含义的翻译）
• TorrentProject（注：此名称可能指一个特定的项目或平台，根据上下文可能有不同的具体翻译，但在此直接保留原名以体现其专有性）
• 以及更多。。。

笔记

• 一些服务提供商可能不支持所有功能（例如，磁力链接）
• 提供商的可用性取决于网络访问和提供商的状态
• 结果会异步返回，可能需要几秒钟时间
• 内置错误处理机制以应对提供商操作失败的情况
• 重要的许多种子网站使用Cloudflare或类似的防护措施，这些措施可能会阻止自动化请求。这是底层种子搜索API库的限制，而非MCP服务器本身的限制。不同的服务提供商可能具有不同的可用性。

验证

运行验证脚本来测试基本功能：

node verify.js

这将测试提供商管理功能，并尝试进行一次简单搜索。

许可证

麻省理工学院（MIT）

致谢/鸣谢

建立在……之上 torrent-search-api 翻译为中文是“种子搜索API” 由吉米·劳伦特（Jimmy Laurent）所著/所作。