YuGiOh Card API MCP Server

YuGiOh Card API MCP サーバー

このプロジェクトは、YuGiOh Card Database（YGOPRODeck）の API のラッパーとして機能する MCP（Model Context Protocol）サーバーを実装します。

説明

このサーバーは、さまざまなフィルタリング条件を使用して YuGiOh のカードを検索するための MCP インターフェースを提供します。カード情報の取得には、YGOPRODeck の公開 API を使用します。

前提条件

• Java 21 以降
• Maven 3.6 以降

インストール

1. リポジトリをクローンします

git clone [url-del-repositorio]

2. プロジェクトをビルドします

mvn clean package

使用方法

MCP サーバーは、カードを絞り込むための複数のパラメーターを受け付ける「yugioh-api」というツールを公開します。使用例をいくつか紹介します。

利用可能なパラメーター

• name：カードの正確な名前（例：「Dark Magician」）
• id：カードの ID（例：「46986414」）
• type：カードの種類（例：「Effect Monster」、「Spell Card」など）
• atk：攻撃力
• def：守備力
• level：カードのレベル／ランク
• race：モンスターの種族（例：「Spellcaster」、「Dragon」など）
• attribute：属性（例：「DARK」、「LIGHT」など）
• archetype：アーキタイプ（例：「Blue-Eyes」）
• sort：結果の並べ替えに使用するフィールド（例：「atk」、「name」）
• format：ゲームのフォーマット（例：「tcg」、「speed duel」）
• banlist：禁止カードリスト（例：「TCG」、「OCG」）
• language：言語（例：「en」、「fr」）

使用例

特定のカードを検索する場合：

{
    "name": "Dark Magician"
}

特定のアーキタイプのカードを検索する場合：

{
    "archetype": "Blue-Eyes"
}

複数の条件でカードを検索する場合：

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

プロジェクト構成

• App.java：MCP サーバーを実装するメインクラス
• YugiohSchema.java：パラメーター検証用の JSON スキーマを定義します