MCP Server – Scryfall API Interface

MCP サーバー – Scryfall API インターフェース

これは、Scryfall API と連携し、Magic: The Gathering のカードデータを詳しく取得して表示する MCP サーバーです。カード名、色、タイプ、テキストの内容でカードを検索できます。

機能

• Scryfall 経由で MTG カードを次の条件で検索します：
  • カード名
  • 色
  • タイプ行
  • Oracle テキスト
• カードデータを詳しく出力します：
  • Oracle テキスト、マナ・コスト、色
  • タイプ、パワー／タフネス、レアリティ
  • セット名
  • USD／EUR 建ての価格（通常版とフォイル版）

プロジェクトのセットアップ

このプロジェクトでは、Python 環境と依存関係の管理に uv を使用しています。すべての依存関係は pyproject.toml で宣言されています。

必要条件

• Python 3.12+
• uv（cargo install uv でインストール）

インストール

uv venv
source .venv/bin/activate  # or `.venv/Scripts/activate` on Windows
uv pip install -r pyproject.toml

プロジェクトの実行

uv run scryfall.py "Atraxa" を実行すると、コンソールに Atraxa カードの Scryfall 検索結果が表示されます。ただし、このプロジェクトは Claude Desktop のような MCP ホストから実行することを想定しています。

Claude Desktop との連携

Claude Desktop は MCP サーバーを実行して Scryfall API とやり取りし、その結果を使用できます。最新バージョンの Claude をインストールするか更新し、まだ存在しない場合は claude_desktop_config.json ファイルを作成する必要があります：

macOS の場合は ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合は $env:AppData\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "scryfall": {
            "command": "/ABSOLUTE/PATH/TO/BIN/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/mcp-server",
                "run",
                "scryfall.py"
            ]
        }
    }
}

テスト

このプロジェクトでは、ユニットテストに pytest を使用しています。テストは tests/ ディレクトリにあります。

テストの実行

テストスイート全体を実行するには：

pytest

特定のテストを実行するには：

pytest tests/test_scryfall.py::test_get_cards_no_query