C411 MCP 서버

c411.org에서 토렌트를 검색하고, 토렌트 메타데이터와 댓글을 가져오며, .torrent 파일을 다운로드하기 위한 MCP(Model Context Protocol) 서버입니다.

기능

c411.org에서 토렌트 검색
infoHash를 통한 상세 토렌트 메타데이터 가져오기
infoHash를 통한 페이지 단위 토렌트 댓글 가져오기
infoHash를 통한 .torrent 파일 다운로드
인증된 세션 자동 재사용
짧은 지연 시간과 제한된 재시도 횟수로 만료된 인증 재시도
누락된 자격 증명, 잘못된 자격 증명, 유지보수 모드 오류 구분
제목, 크기, 시더 수, 사용 가능한 경우 infoHash를 포함한 구조화된 검색 결과 반환

설치

npm install

사용법

서버 실행

서버는 기본적으로 stdio 전송을 사용합니다:

npm run dev

또는 빌드 후 실행:

npm run build
npm start

인증

c411.org는 토렌트 목록에 액세스하기 위해 인증이 필요합니다. 로그인을 활성화하려면:

다음 환경 변수를 설정하세요:
- C411_USERNAME: c411.org 사용자 이름
- C411_PASSWORD: c411.org 비밀번호
서버가 자동으로 로그인하고 세션을 유지합니다.

자격 증명이 없으면 서버가 검색 결과를 가져오지 못할 수 있습니다.

인증 실패 시 동작

서버는 인증 실패 시 더 구체적인 오류를 반환하려고 시도합니다:

자격 증명 누락: 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의 경우, 로컬 MCP 항목을 사용하여 mcp 아래의 OpenCode 설정에서 서버를 구성하세요:

{
  "$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자 16진수 infoHash

반환값: 제목, 카테고리, 크기, 시더 및 리처 수, 완료 횟수, 업로더, 생성 날짜, 파일 목록, 사용 가능한 경우 TMDB 데이터, 신뢰 정보를 포함한 구조화된 토렌트 메타데이터.

get_c411_torrent_comments

c411.org의 토렌트에 대한 페이지 단위 댓글을 가져옵니다.

매개변수:

infoHash (string, 필수): 토렌트의 40자 16진수 infoHash
page (number, 선택): 댓글 페이지 번호. 기본값은 1.
limit (number, 선택): 페이지당 댓글 수. 기본값은 20, 최대 100.

반환값: 페이지 매김 메타데이터와 정규화된 댓글 항목(HTML 콘텐츠, 일반 텍스트 콘텐츠, 작성자 정보, 타임스탬프, 답글 대상 포함)을 포함한 구조화된 댓글 결과.

download_c411_torrent

c411.org에서 .torrent 파일을 다운로드하여 디스크에 저장합니다.

매개변수:

infoHash (string, 필수): 토렌트의 40자 16진수 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의 서비스 약관을 준수하세요
자격 증명을 안전하게 보관하세요
웹사이트 구조가 변경되면 스크레이퍼 업데이트가 필요할 수 있습니다

C411 MCP Server

C411 MCP 서버

목차

기능

설치

사용법

서버 실행

인증

인증 실패 시 동작

MCP 클라이언트 설정

도구

search_c411

list_my_c411_uploads

get_c411_torrent_info

get_c411_torrent_comments

download_c411_torrent

프로젝트 구조

개발

참고 사항

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API