MCP Server – Scryfall API Interface

MCP 服务 – Scryfall API 接口

这是一个 MCP 服务，可与 Scryfall API 对接，以获取并显示详细的万智牌卡牌数据。它支持按名称、颜色、类别和文本内容搜索卡牌。

功能

• 通过 Scryfall 搜索万智牌卡牌，支持按以下条件搜索：
  • 卡牌名称
  • 颜色
  • 类别行
  • Oracle 文本
• 输出详细的卡牌数据：
  • Oracle 文本、法术力费用、颜色
  • 类别、力量/防御力、稀有度
  • 系列名称
  • USD/EUR 价格（普通版和闪卡）

项目设置

本项目使用 uv 管理 Python 环境和依赖项。所有依赖项均在 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 搜索结果，不过本项目旨在由 MCP 宿主（例如 Claude Desktop）运行。

与 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