mangadex-mcp

Lokaler stdio MCP-Server zum Durchsuchen von MangaDex, Lesen von Manga-Metadaten, Auflisten von Kapiteln und Exportieren interner Kapitel als CBZ oder PDF.

Funktionen

• Suche nach MangaDex-Titeln nach Namen

• Abrufen von Manga-Metadaten und externen Links

• Auflisten aktueller englischer Kapitel für einen Manga

• Rückgabe von Informationen zum Lesezugriff auf Kapitel-Ebene

• Exportieren interner MangaDex-Kapitel in lokale CBZ-Dateien

• Exportieren interner MangaDex-Kapitel in lokale PDF-Dateien

Related MCP server: MAL MCP Server

Anforderungen

• Node.js 20+

• npm

Installation

npm install

Ausführung

npm start

MCP-Start

Dieser Server verwendet den MCP stdio-Transport und ist dafür vorgesehen, lokal von einem MCP-Client gestartet zu werden.

Beispiel:

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

Werkzeuge

search_manga

Suche auf MangaDex nach Titeln.

Eingabe:

{
  "query": "berserk"
}

get_manga_details

Abrufen detaillierter Metadaten und zugeordneter externer Links für einen Manga.

Eingabe:

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

get_manga_chapters

Auflisten aktueller englischer Kapitel für einen Manga.

Eingabe:

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

get_chapter_access_info

Rückgabe von Zugriffsinformationen auf Kapitel-Ebene. Für interne MangaDex-Kapitel verweist dies auf den MangaDex-Reader. Für extern gehostete Kapitel wird die externe Reader-URL zurückgegeben. MangaDex stellt über diese API keine PDF/CBZ-Download-URLs bereit.

Eingabe:

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

export_chapter_cbz

Exportieren eines internen MangaDex-Kapitels in eine lokale CBZ-Datei. Das Werkzeugergebnis enthält auch einen resource_link-Block, der auf die exportierte Datei verweist.

Eingabe:

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

export_chapter_pdf

Exportieren eines internen MangaDex-Kapitels in eine lokale PDF-Datei. Das Werkzeugergebnis enthält auch einen resource_link-Block, der auf die exportierte Datei verweist.

Eingabe:

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

get_manga_external_links

Nur die externen Links für einen Manga zurückgeben.

Eingabe:

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

Lokale Überprüfung

npm run smoke

Hinweise

• export_chapter_cbz funktioniert nur für interne, auf MangaDex gehostete Kapitel.

• export_chapter_pdf funktioniert nur für interne, auf MangaDex gehostete Kapitel.

• Externe Kapitel, wie z. B. MangaPlus-Links, können nicht über MangaDex exportiert werden.

• Der PDF-Export unterstützt derzeit Kapitel-Seiten im Format jpg, jpeg oder png.

• Der Server führt Live-Anfragen an https://api.mangadex.org durch.