mangadex-mcp

MangaDex 검색, 만화 메타데이터 읽기, 챕터 목록 확인, 내부 챕터를 CBZ 또는 PDF로 내보내기 위한 로컬 stdio MCP 서버입니다.

기능

• 이름으로 MangaDex 타이틀 검색

• 만화 메타데이터 및 외부 링크 가져오기

• 만화의 최근 영어 챕터 목록 확인

• 챕터 수준의 리더 액세스 정보 반환

• 내부 MangaDex 챕터를 로컬 CBZ 파일로 내보내기

• 내부 MangaDex 챕터를 로컬 PDF 파일로 내보내기

Related MCP server: MAL MCP Server

요구 사항

• Node.js 20+

• npm

설치

npm install

실행

npm start

MCP 실행

이 서버는 MCP stdio 전송을 사용하며 MCP 클라이언트에 의해 로컬에서 실행되도록 설계되었습니다.

예시:

{
  "command": "node",
  "args": ["C:\\Users\\[NAME]\\mangadex-mcp\\src\\index.js"]
}

도구

search_manga

제목으로 MangaDex를 검색합니다.

입력:

{
  "query": "berserk"
}

get_manga_details

만화에 대한 상세 메타데이터와 매핑된 외부 링크를 가져옵니다.

입력:

{
  "mangaId": "801513ba-a712-498c-8f57-cae55b38cc92"
}

get_manga_chapters

만화의 최근 영어 챕터 목록을 확인합니다.

입력:

{
  "mangaId": "801513ba-a712-498c-8f57-cae55b38cc92",
  "limit": 10,
  "offset": 0
}

get_chapter_access_info

챕터 수준의 액세스 정보를 반환합니다. 내부 MangaDex 챕터의 경우 MangaDex 리더를 가리킵니다. 외부 호스팅 챕터의 경우 외부 리더 URL을 반환합니다. MangaDex는 이 API를 통해 PDF/CBZ 다운로드 URL을 제공하지 않습니다.

입력:

{
  "chapterId": "8ceadc31-e41e-4038-8aef-d002aab344a5"
}

export_chapter_cbz

내부 MangaDex 챕터를 로컬 CBZ 파일로 내보냅니다. 도구 결과에는 내보낸 파일을 가리키는 resource_link 블록도 포함됩니다.

입력:

{
  "chapterId": "8ceadc31-e41e-4038-8aef-d002aab344a5",
  "quality": "data-saver",
  "outputDir": "exports/chapters"
}

export_chapter_pdf

내부 MangaDex 챕터를 로컬 PDF 파일로 내보냅니다. 도구 결과에는 내보낸 파일을 가리키는 resource_link 블록도 포함됩니다.

입력:

{
  "chapterId": "8ceadc31-e41e-4038-8aef-d002aab344a5",
  "quality": "data-saver",
  "outputDir": "exports/chapters"
}

get_manga_external_links

만화의 외부 링크만 반환합니다.

입력:

{
  "mangaId": "801513ba-a712-498c-8f57-cae55b38cc92"
}

로컬 검증

npm run smoke

참고 사항

• export_chapter_cbz는 내부 MangaDex 호스팅 챕터에서만 작동합니다.

• export_chapter_pdf는 내부 MangaDex 호스팅 챕터에서만 작동합니다.

• MangaPlus 링크와 같은 외부 챕터는 MangaDex를 통해 내보낼 수 없습니다.

• PDF 내보내기는 현재 jpg, jpeg 또는 png로 제공되는 챕터 페이지를 지원합니다.

• 서버는 https://api.mangadex.org에 실시간 요청을 보냅니다.