C411 MCP 服务器

一个用于在 c411.org 上搜索种子、获取种子元数据和评论，以及下载 .torrent 文件的 MCP (Model Context Protocol) 服务器。

目录

• 功能

• 安装

• 使用

  • 运行服务器

  • 身份验证

  • 认证失败行为

  • MCP 客户端配置

• 工具

  • search_c411

  • get_c411_torrent_info

  • get_c411_torrent_comments

  • download_c411_torrent

• 项目结构

• 开发

• 注意事项

功能

• 在 c411.org 上搜索种子

• 通过 infoHash 获取详细的种子元数据

• 通过 infoHash 获取分页的种子评论

• 通过 infoHash 下载 .torrent 文件

• 自动重用已认证的会话

• 在认证过期时进行带小延迟和有限重试次数的重试

• 区分凭据缺失、凭据无效和维护模式故障

• 返回结构化的搜索结果，包含标题、大小、做种数以及可用的 infoHash

安装

npm install

使用

运行服务器

服务器默认使用 stdio 传输：

npm run dev

或者构建并运行：

npm run build
npm start

身份验证

c411.org 需要身份验证才能访问种子列表。要启用登录：

1. 设置以下环境变量：

   • C411_USERNAME: 您的 c411.org 用户名

   • C411_PASSWORD: 您的 c411.org 密码

2. 服务器将自动登录并维护会话。

如果没有凭据，服务器可能无法检索搜索结果。

认证失败行为

当身份验证失败时，服务器会尝试返回更具体的错误：

• 凭据缺失：要求提供 C411_USERNAME 和 C411_PASSWORD

• 凭据无效：报告用户名/密码被拒绝

• 维护模式：报告 c411.org 暂时不可用

• 网络或超时问题：返回经过脱敏的传输错误，不记录凭据

HTTP 请求在 10 秒后超时。

MCP 客户端配置

要将此服务器与 MCP 客户端（如 Claude Desktop）一起使用，请添加到您的客户端配置中：

{
  "mcpServers": {
    "c411": {
      "command": "node",
      "args": ["/path/to/c411-mcp-server/build/index.js"],
      "env": {
        "C411_USERNAME": "your_username",
        "C411_PASSWORD": "your_password"
      }
    }
  }
}

对于 OpenCode，请在 OpenCode 配置的 mcp 下使用本地 MCP 条目配置服务器：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "c411": {
      "type": "local",
      "command": ["node", "/path/to/c411-mcp-server/build/index.js"],
      "enabled": true,
      "environment": {
        "C411_USERNAME": "your_username",
        "C411_PASSWORD": "your_password"
      }
    }
  }
}

OpenCode 在 mcp 键下记录 MCP 服务器，本地服务器使用 type: "local"、command 数组和用于环境变量的 environment。

您也可以通过 OpenCode CLI 添加它：

opencode mcp add

然后选择一个本地 MCP 服务器并输入等效值：

• name: c411

• type: local

• command: node /path/to/c411-mcp-server/build/index.js

• environment:

  • C411_USERNAME=your_username

  • C411_PASSWORD=your_password

之后，您可以使用以下命令验证它是否已添加：

opencode mcp list

工具

search_c411

在 c411.org 上搜索种子。

参数：

• query (string, 必填): 搜索查询，已修剪，1 到 200 个字符

• category (string, 可选): 分类过滤器。1, 2, 3, 4, 5, 6, 7, 10 之一。

• subcat (string, 可选): 子分类过滤器。仅在 category 为 1 时有效。

• sortBy (string, 可选): 排序标准。relevance, seeders, leechers, size, createdAt, name, completions, comments, category 之一。默认为 relevance。

• sortOrder (string, 可选): 排序顺序。asc, desc 之一。默认为 desc。

• page (number, 可选): 结果页码。默认为 1。

• perPage (number, 可选): 每页结果数。默认为 25，最大 100。

返回： 包含标题、大小、做种数以及可用 infoHash 的种子结果列表。

list_my_c411_uploads

列出当前已认证的 c411.org 用户上传的种子。

参数：

• query (string, 可选): 搜索查询，已修剪，1 到 200 个字符。

• category (string, 可选): 分类过滤器。1, 2, 3, 4, 5, 6, 7, 10 之一。

• subcat (string, 可选): 子分类过滤器。仅在 category 为 1 时有效。

• sortBy (string, 可选): 排序标准。relevance, seeders, leechers, size, createdAt, name, completions, comments, category 之一。默认为 relevance。

• sortOrder (string, 可选): 排序顺序。asc, desc 之一。默认为 desc。

• page (number, 可选): 结果页码。默认为 1。

• perPage (number, 可选): 每页结果数。默认为 100，最大 100。

返回： 当前用户上传的种子结果列表，使用与 search_c411 相同的结构。

get_c411_torrent_info

获取 c411.org 上种子的详细元数据。

参数：

• infoHash (string, 必填): 种子的 40 字符十六进制 infoHash

返回： 结构化的种子元数据，包括标题、分类、大小、做种者和下载者数量、完成数、上传者、创建日期、文件列表、可用的 TMDB 数据以及信任信息。

get_c411_torrent_comments

获取 c411.org 上种子的分页评论。

参数：

• infoHash (string, 必填): 种子的 40 字符十六进制 infoHash

• page (number, 可选): 评论页码。默认为 1。

• limit (number, 可选): 每页评论数。默认为 20，最大 100。

返回： 带有分页元数据和标准化评论条目的结构化评论结果，包括 HTML 内容、纯文本内容、作者信息、时间戳以及（如果存在）回复目标。

download_c411_torrent

从 c411.org 下载 .torrent 文件并保存到磁盘。

参数：

• infoHash (string, 必填): 种子的 40 字符十六进制 infoHash

• outputDir (string, 可选): 保存 .torrent 文件的目录。默认为 /tmp。

返回： 已保存 .torrent 文件的完整路径。

示例：

infoHash: "178a3516f248e45f9857abbc2cbc8a8b20f29815"
outputDir: "/tmp"

项目结构

• src/index.ts: 仅引导；创建 MCP 服务器并启动 stdio

• src/c411-client.ts: c411 认证、重试、搜索、种子信息、评论和下载逻辑

• src/register-tools.ts: MCP 工具注册

• src/formatters.ts: 用于搜索、种子信息和评论的格式化和标准化辅助工具

• src/http-response-utils.ts: 响应解析和维护检测辅助工具

• src/http-client.ts: 隔离的 Axios + cookie-jar 设置

• src/schemas.ts: Zod 工具模式

• src/types.ts: 共享的 TypeScript 类型

开发

• npm run dev: 在开发模式下运行并热重载

• npm run build: 将 TypeScript 编译为 JavaScript

• npm start: 运行已编译的服务器

注意事项

• 此服务器仅供个人使用

• 请遵守 c411.org 的服务条款

• 请妥善保管您的凭据

• 如果网站结构发生变化，爬虫可能需要更新