Skip to content
Notifications You must be signed in to change notification settings

code-ga/mangadex-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3eb56f6 · · Jul 31, 2025

History

1 Commit
Jul 31, 2025
Jul 31, 2025
Jul 31, 2025
Jul 31, 2025
Jul 31, 2025
Jul 31, 2025
Jul 31, 2025

Repository files navigation

MangaDex MCP Server

Version License

A server application built with the Model Context Protocol (MCP) SDK to interact with the MangaDex API. This server provides a set of tools for searching and retrieving manga information, including volumes, chapters, and covers, as well as additional utilities for fetching otaku GIFs and BBC news in multiple languages.

Features

  • Search Manga: Search for manga using various parameters like title, author, tags, and more.
  • Get Manga Details: Retrieve detailed information about a specific manga by ID.
  • Manga Volumes and Chapters: Fetch volumes and chapters for a given manga.
  • Manga Covers: Get cover images associated with a manga.
  • Random Manga: Discover a random manga from the MangaDex database.
  • Otaku GIFs: Fetch GIFs based on reactions from the OtakuGIFs API.
  • BBC News: Get the latest news or general news in various languages using the BBC News API.
  • Login to MangaDex: Authenticate with MangaDex using personal credentials for enhanced access.

Installation

To install dependencies:

bun install

Usage

To run the server:

bun run index.ts

Tools

This server exposes several tools via the MCP protocol:

  • search-manga: Search for manga with customizable query parameters.
  • get-manga: Retrieve information about a specific manga.
  • get-manga-volumes: Get volume information for a manga.
  • get-manga-covers: Fetch cover art for a manga.
  • get-manga-chapters: List chapters for a manga.
  • get-random-manga: Get a randomly selected manga.
  • get-otaku-gif: Retrieve a GIF based on a specified reaction.
  • login-to-mangadex: Log in to MangaDex with personal credentials.
  • get-bbc-news: Fetch news articles from BBC in various languages.
  • get-bbc-latest-news: Get the latest news from BBC in various languages.

Development

This project was created using bun init in bun v1.2.11. Bun is a fast all-in-one JavaScript runtime.

To build the project:

bun run build

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published