Ygocdb MCP

🚀 百鸽(ygocdb.com) MCP Server

English | 中文

このサーバーは、Model Context Protocol (MCP) をベースに構築されており、百鸽(ygocdb.com) などの API とのやり取りを可能にします。遊戯王の中国語カード情報を検索するための一連のツールを提供します。

🚀 クイックスタート

このサーバーは、遊戯王カードデータベースの公開 API を利用しています。以下のように、様々な機能を利用することができます。

✨ 主な機能

• search_cards
  キーワードを使って遊戯王カードを検索できます。カード名や効果テキストなどを検索対象にできます。

• get_card_by_id
  カード ID を指定することで、単一の遊戯王カードの詳細情報を取得できます。

• get_card_image
  カード ID を指定することで、遊戯王カードの画像を取得できます。

📦 インストール

サーバーは 2 つの実行モードをサポートしています。

1. 標準の stdio モード（デフォルト）
2. ステートレスな Streamable HTTP モード（HTTP エンドポイントを提供）

NPX を使用する場合

Node.js がローカルにインストールされている場合は、以下のコマンドで実行できます。

# Stdio モード
npx ygocdb-mcp-server

# Streamable HTTP モード
npx ygocdb-mcp-server --http

Docker を使用する場合

以下のコマンドで Docker イメージをビルドします。

docker build -t mcp/ygocdb .

その後、以下のコマンドで実行できます。

# Stdio モード
docker run -i --rm mcp/ygocdb

# Streamable HTTP モード
docker run -i --rm -p 3000:3000 mcp/ygocdb --http

claude_desktop_config.json への統合

stdio モードの例を以下に示します。

{
  "mcpServers": {
    "ygocdb": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/ygocdb"]
    }
  }
}

または、NPX を使用する場合は以下のように設定します。

{
  "mcpServers": {
    "ygocdb": {
      "command": "npx",
      "args": ["ygocdb-mcp-server"]
    }
  }
}

💻 使用例

基本的な使用法

本サーバーは、遊戯王カードデータベースの公開 API を利用しています。以下は、API の使用例です。

• カード検索: https://ygocdb.com/api/v0/?search=キーワード
• カード画像: https://cdn.233.momobako.com/ygopro/pics/<id>.jpg

高度な使用法

サーバーに接続する方法は、実行モードによって異なります。

Stdio モード

アプリケーションや環境（例: Claude Desktop）は、stdio を介してサーバーと直接通信できます。

Streamable HTTP モード

--http パラメータを使用して Streamable HTTP モードで実行すると、サーバーは以下のエンドポイントで利用可能になります。

• Streamable HTTP エンドポイント: http://localhost:3000/mcp

このモードはステートレスで、セッション情報を維持しないため、よりシンプルで効率的な通信方式を提供します。

📚 ドキュメント

API ドキュメント

本サーバーは、遊戯王カードデータベースの公開 API を利用しています。以下は、API のエンドポイントです。

• カード検索: https://ygocdb.com/api/v0/?search=キーワード
• カード画像: https://cdn.233.momobako.com/ygopro/pics/<id>.jpg