nhentai-mcp

MCP server for nhentai.net API v2 via stdio.

Tools (12)

• search_galleries — query syntax: language:english, artist:name, tag:"...", -tag, pages:>20, uploaded:<7d; sort date|popular|popular-today|popular-week|popular-month
• get_gallery — full details by ID (include: comments,related,favorite,suggestions)
• get_gallery_image_urls — resolved CDN URLs for every page + cover
• get_recent_galleries / get_popular_galleries / get_random_gallery / get_galleries_by_tag / get_related_galleries
• get_gallery_comments — paginated comments
• get_download_url — zip/cbz/torrent (requires auth)
• get_cdn_config — image/thumb servers + announcement
• get_favorites — authenticated user's favorites

Requirements

• Node.js >= 18

Setup

npm install
npm run build
npm start        # runs dist/index.js via stdio
npm run inspect  # MCP inspector

Env (optional, raises rate limits / unlocks favorites & downloads)

NHENTAI_API_KEY=Key ...      # generate at https://nhentai.net/user/settings#apikeys
# or
NHENTAI_USER_TOKEN=...
NHENTAI_USER_AGENT=your-app/1.0 (contact)

MCP config (opencode / Claude Code)

{
  "mcpServers": {
    "nhentai": {
      "command": "node",
      "args": ["/home/nanakura/Projects/nhentai-mcp/dist/index.js"],
      "env": { "NHENTAI_API_KEY": "..." }
    }
  }
}

API is public; no key needed for search/gallery except favorites/download/blacklist.

License

MIT — Copyright (c) 2026 nachoneko. See LICENSE for details.