Scryfall MCP

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

このプロジェクトは、Scryfall API と接続する MCP サーバーです。標準的なマジック・ザ・ギャザリング (Magic: The Gathering) のカードの詳細データを取得し、表示することができます。カード名、色、タイプ、テキスト内容などを使ってカードを検索することが可能です。

✨ 主な機能

• Scryfall を通じた MTG カードの検索：
  • カード名
  • 色（単色または複数色）
  • タイプライン
  • カードの説明文
• 詳細なカードデータの出力：
  • カードの説明文、マナコスト、色
  • タイプ、パワー/タフネス、レア度
  • カードシリーズ名
  • ドルとユーロ（通常版と箔版）の価格

📦 インストール

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

前提条件

• Python 3.12 以上のバージョン
• uv（cargo install uv でインストール）

インストール手順

uv venv
source .venv/bin/activate  # または Windows の場合は `.venv/Scripts/activate`
uv pip install -r pyproject.toml

プロジェクトの実行

uv run scryfall.py "Atraxa" を実行すると、Atraxa カードの Scryfall 検索結果が表示されます。ただし、このプロジェクトは MCP ホスト（Claude Desktop など）での実行を想定しています。

Claude Desktop との統合

Claude Desktop でこの MCP サーバーを実行し、Scryfall API と接続して結果を利用することができます。最新バージョンの Claude をインストールまたは更新し、その設定ファイルに以下の内容を追加してください（存在しない場合は作成します）。

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"
            ]
        }
    }
}

💻 使用例

基本的な使用法

uv run scryfall.py "Atraxa"

高度な使用法

# 特定のテストを実行する場合
pytest tests/test_scryfall.py::test_get_cards_no_query

📚 ドキュメント

このプロジェクトでは、pytest を使ってユニットテストを行っています。テストファイルは tests/ フォルダにあります。

テストの実行

完全なテストスイートを実行するには、以下のコマンドを実行します。

pytest

特定のテストを実行するには、以下のようにコマンドを実行します。

pytest tests/test_scryfall.py::test_get_cards_no_query