mangadex-mcp

Локальный MCP-сервер stdio для поиска на MangaDex, чтения метаданных манги, получения списка глав и экспорта внутренних глав в CBZ или PDF.

Возможности

• Поиск названий манги на 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 не предоставляет URL для скачивания PDF/CBZ через этот API.

Входные данные:

{
  "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.