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 发出实时请求。