mcp-server-yugioh
If you are the rightful owner of mcp-server-yugioh and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
YuGiOh Card API MCP Server acts as a wrapper for the YGOPRODeck API, providing an MCP interface for searching YuGiOh cards using various filtering criteria.
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
- Clonar el repositorio
git clone [url-del-repositorio]
- 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 MCPYugiohSchema.java: Define el schema JSON para la validación de parámetros
