mcpField
Y
YuGiOh Card API MCP Server

YuGiOh Card API MCP Server

Local
github.com/martinezFisiDeveloper Tools0Updated 78w ago
Repository

About YuGiOh Card API MCP Server

YuGiOh Card API MCP Server wraps the public YGOPRODeck API for card searches. It is for clients that need to find cards using detailed filters such as type, stats, archetype, format, or language.

Key features

  1. 01Search by card name or ID
  2. 02Filter by type, stats, race, and attribute
  3. 03Filter by archetype and game format
  4. 04Sort results and select language
  5. 05Apply banlist criteria

Use cases

  1. 01Find a card by its exact name or ID
  2. 02Search cards by archetype
  3. 03Narrow cards by type and attribute
  4. 04Query cards under a game format or banlist

MCP support

The MCP server exposes a `yugioh-api` tool that searches the YGOPRODeck API using card filters.

#yu-gi-oh#api#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

YuGiOh Card API MCP Server

Este proyecto implementa un servidor MCP (Model Context Protocol) que actúa como wrapper para la API de YuGiOh Card Database (YGOPRODeck).

Descripción

El servidor proporciona una interfaz MCP para buscar cartas de YuGiOh utilizando diversos criterios de filtrado. Utiliza la API pública de YGOPRODeck para obtener la información de las cartas.

Requisitos Previos

  • Java 21 o superior
  • Maven 3.6 o superior

Instalación

  1. Clonar el repositorio
git clone [url-del-repositorio]
  1. Construir el proyecto
mvn clean package

Uso

El servidor MCP expone una herramienta llamada "yugioh-api" que acepta varios parámetros para filtrar cartas. Algunos ejemplos de uso:

Parámetros Disponibles
  • name: Nombre exacto de la carta (ej: "Dark Magician")
  • id: ID de la carta (ej: "46986414")
  • type: Tipo de carta (ej: "Effect Monster", "Spell Card", etc.)
  • atk: Puntos de ataque
  • def: Puntos de defensa
  • level: Nivel/Rango de la carta
  • race: Tipo de monstruo (ej: "Spellcaster", "Dragon", etc.)
  • attribute: Atributo (ej: "DARK", "LIGHT", etc.)
  • archetype: Arquetipo (ej: "Blue-Eyes")
  • sort: Campo para ordenar resultados (ej: "atk", "name")
  • format: Formato del juego (ej: "tcg", "speed duel")
  • banlist: Lista de prohibidas (ej: "TCG", "OCG")
  • language: Idioma (ej: "en", "fr")
Ejemplos de Uso

Para buscar una carta específica:

{
    "name": "Dark Magician"
}

Para buscar cartas de un arquetipo específico:

{
    "archetype": "Blue-Eyes"
}

Para buscar cartas con criterios múltiples:

{
    "type": "Effect Monster",
    "attribute": "DARK",
    "race": "Spellcaster"
}

Estructura del Proyecto

  • App.java: Clase principal que implementa el servidor MCP
  • YugiohSchema.java: Define el schema JSON para la validación de parámetros

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.