Scryfall

🚀 Scryfall MCP サーバー

このサーバーは、Scryfall API とやり取りするための Model Context Protocol (MCP) サーバーです。Magic: The Gathering のカードの詳細情報、カードルール、価格情報を検索するツールを提供します。

✨ 主な機能

• カード検索
  テキストを使って Scryfall 上で検索を実行し、一致するカードのリストを返します。
• ID でカードを取得
  Scryfall UUID を使って直接カードを取得します。
• 名称でカードを取得
  英語名で正確にカードを検索します。
• ランダムなカードを取得
  Scryfall のデータベース全体からランダムなカードを取得します。
• ルールを取得
  特定のカードの公式ルールを取得します。これらのルールは、カードの相互作用やゲームルールを説明している場合があります。
• ID で価格情報を取得
  Scryfall ID を使って現在の価格情報（USD、USD 金箔、EUR、TIX）を取得します。
• 名称で価格情報を取得
  英語名で正確にカードの現在の価格情報（USD、USD 金箔、EUR、TIX）を取得します。

🚀 クイックスタート

このサーバーは、2 つのモードで実行できます。

1. 標準の stdio モード（デフォルト）
2. Server-Sent Events (SSE) モード（HTTP エンドポイント付き）

NPX を使用する場合

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

# Stdio モード
npx scryfall-mcp-server

# SSE モード
npx scryfall-mcp-server --sse

サーバーへの接続

Stdio モード

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

SSE モード

--sse オプションを使用して SSE モードでサーバーを実行する場合、MCP CLI を使用して接続できます。

npx @wong2/mcp-cli --sse http://localhost:3000/sse

サーバーは以下の場所で利用できます。

• SSE エンドポイント: http://localhost:3000/sse
• メッセージエンドポイント: http://localhost:3000/messages

claude_desktop_config.json への統合

以下は、Stdio モードでの統合例です。

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

または npx を使用する場合:

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

Docker を使用したビルド

docker build -t mcp/scryfall .

その後、Stdio モードで実行するには:

docker run -i --rm mcp/scryfall

SSE モードで実行するには:

docker run -i --rm -p 3000:3000 mcp/scryfall --sse

📄 ライセンス

本プロジェクトは MIT ライセンスの下で公開されています。