Scryfall MCP

🚀 MCP 服務器——Scryfall API 接口

這是一個與 Scryfall API 對接的 MCP 服務器，可獲取並展示詳細的標準萬智牌 (Magic: The Gathering) 卡牌數據。它支持通過卡牌名稱、顏色、類型和文本內容搜索卡牌，為萬智牌愛好者和開發者提供了便捷的卡牌信息查詢方式。

✨ 主要特性

• 通過 Scryfall 搜索 MTG 卡牌：
  • 卡牌名稱：可根據具體的卡牌名稱精準搜索。
  • 顏色（單色或多色）：支持按單色或多色組合搜索卡牌。
  • 類型線：依據卡牌的類型線進行篩選。
  • 牌面描述文本：通過牌面上的描述文本查找相關卡牌。
• 詳細卡牌數據輸出：
  • 牌面描述文本、法力成本、顏色：提供卡牌的基本信息。
  • 類型、力量/耐力、稀有度：展示卡牌的屬性和稀有程度。
  • 卡牌系列名稱：明確卡牌所屬的系列。
  • 美元和歐元（普通和foil）價格：提供不同版本卡牌的價格信息。

📦 安裝指南

該項目使用 uv 進行 Python 環境和依賴管理，所有依賴項已聲明在 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，並在其配置文件中添加以下內容（如果不存在則創建）：

• ~/Library/Application\ Support/Claude/claude_desktop_config.json 在 MacOS 上
• $env:AppData\Claude\claude_desktop_config.json 在 Windows 上

{
    "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