# mangadex-mcp

Local `stdio` MCP server for searching MangaDex, reading manga metadata, listing chapters, and exporting internal chapters to `CBZ` or `PDF`.

## Features

- Search MangaDex titles by name
- Fetch manga metadata and external links
- List recent English chapters for a manga
- Return chapter-level reader access info
- Export internal MangaDex chapters to local `CBZ` files
- Export internal MangaDex chapters to local `PDF` files

## Requirements

- Node.js 20+
- npm

## Install

```bash
npm install
```

## Run

```powershell
npm start
```

## MCP Launch

This server uses the MCP `stdio` transport and is intended to be spawned locally by an MCP client.

Example:

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

## Tools

### `search_manga`

Search MangaDex by title.

Input:

```json
{
  "query": "berserk"
}
```

### `get_manga_details`

Fetch detailed metadata and mapped external links for a manga.

Input:

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

### `get_manga_chapters`

List recent English chapters for a manga.

Input:

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

### `get_chapter_access_info`

Return chapter-level access info. For internal MangaDex chapters this points to the MangaDex reader. For external-hosted chapters this returns the external reader URL. MangaDex does not expose PDF/CBZ download URLs through this API.

Input:

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

### `export_chapter_cbz`

Export an internal MangaDex chapter to a local `CBZ` file.
The tool result also includes a `resource_link` block pointing at the exported file.

Input:

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

### `export_chapter_pdf`

Export an internal MangaDex chapter to a local `PDF` file.
The tool result also includes a `resource_link` block pointing at the exported file.

Input:

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

### `get_manga_external_links`

Return only the external links for a manga.

Input:

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

## Local Verification

```powershell
npm run smoke
```

## Notes

- `export_chapter_cbz` only works for internal MangaDex-hosted chapters.
- `export_chapter_pdf` only works for internal MangaDex-hosted chapters.
- External chapters such as MangaPlus links cannot be exported through MangaDex.
- `PDF` export currently supports chapter pages delivered as `jpg`, `jpeg`, or `png`.
- The server makes live requests to `https://api.mangadex.org`.