C411 MCP サーバー

c411.org でのトレント検索、トレントのメタデータやコメントの取得、.torrent ファイルのダウンロードを行うための MCP (Model Context Protocol) サーバーです。

目次

• 機能

• インストール

• 使用方法

  • サーバーの実行

  • 認証

  • 認証失敗時の動作

  • MCP クライアントの設定

• ツール

  • search_c411

  • get_c411_torrent_info

  • get_c411_torrent_comments

  • download_c411_torrent

• プロジェクト構造

• 開発

• 注意点

Related MCP server: RuTracker MCP Server

機能

• 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 が一時的に利用不可であることを報告します