mangadex-mcp

Servidor MCP stdio local para buscar en MangaDex, leer metadatos de manga, listar capítulos y exportar capítulos internos a CBZ o PDF.

Características

• Buscar títulos de MangaDex por nombre

• Obtener metadatos de manga y enlaces externos

• Listar capítulos recientes en inglés de un manga

• Devolver información de acceso al lector a nivel de capítulo

• Exportar capítulos internos de MangaDex a archivos CBZ locales

• Exportar capítulos internos de MangaDex a archivos PDF locales

Related MCP server: MAL MCP Server

Requisitos

• Node.js 20+

• npm

Instalación

npm install

Ejecución

npm start

Lanzamiento de MCP

Este servidor utiliza el transporte stdio de MCP y está diseñado para ser iniciado localmente por un cliente MCP.

Ejemplo:

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

Herramientas

search_manga

Buscar en MangaDex por título.

Entrada:

{
  "query": "berserk"
}

get_manga_details

Obtener metadatos detallados y enlaces externos mapeados para un manga.

Entrada:

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

get_manga_chapters

Listar capítulos recientes en inglés de un manga.

Entrada:

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

get_chapter_access_info

Devolver información de acceso a nivel de capítulo. Para capítulos internos de MangaDex, esto apunta al lector de MangaDex. Para capítulos alojados externamente, esto devuelve la URL del lector externo. MangaDex no expone URLs de descarga de PDF/CBZ a través de esta API.

Entrada:

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

export_chapter_cbz

Exportar un capítulo interno de MangaDex a un archivo CBZ local. El resultado de la herramienta también incluye un bloque resource_link que apunta al archivo exportado.

Entrada:

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

export_chapter_pdf

Exportar un capítulo interno de MangaDex a un archivo PDF local. El resultado de la herramienta también incluye un bloque resource_link que apunta al archivo exportado.

Entrada:

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

get_manga_external_links

Devolver solo los enlaces externos de un manga.

Entrada:

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

Verificación local

npm run smoke

Notas

• export_chapter_cbz solo funciona para capítulos alojados internamente en MangaDex.

• export_chapter_pdf solo funciona para capítulos alojados internamente en MangaDex.

• Los capítulos externos, como los enlaces de MangaPlus, no se pueden exportar a través de MangaDex.

• La exportación a PDF actualmente admite páginas de capítulos entregadas como jpg, jpeg o png.

• El servidor realiza solicitudes en tiempo real a https://api.mangadex.org.