MCP Server – Scryfall API Interface

基本能力

产品定位

scryfall-mcp 是一个专门为《魔法风云会》卡牌数据查询设计的 MCP 服务，通过 Scryfall API 提供丰富的卡牌信息查询功能。

核心功能

• 通过 Scryfall API 搜索《魔法风云会》卡牌，支持以下搜索条件：
• 卡牌名称
• 颜色
• 类型
• 文本内容
• 提供详细的卡牌数据输出，包括：
• 文本描述、法力值消耗、颜色
• 类型、力量/防御力、稀有度
• 系列名称
• 普通版和闪卡版的价格（美元/欧元）

适用场景

• 《魔法风云会》玩家快速查询卡牌信息
• 卡牌收藏管理
• 卡牌交易价格参考
• 游戏策略研究和卡组构建

使用教程

使用依赖

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

• 运行测试：

pytest  # 运行全部测试
pytest tests/test_scryfall.py::test_get_cards_no_query  # 运行特定测试

与 Claude Desktop 集成

1. 安装或更新最新版 Claude Desktop
2. 创建或编辑配置文件：
3. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
4. Windows: $env:AppData\Claude\claude_desktop_config.json
5. 添加以下配置：

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

许可证

该项目遵循 None 开源许可条款。