使用说明

项目简介

本项目提供了一组 Model Context Protocol (MCP) 服务器，旨在通过 Claude 等 MCP 客户端，为用户提供便捷的万智牌（Magic: The Gathering, MTG）套牌管理和卡牌信息查询功能。您可以上传自己的套牌，模拟抽牌、调度，以及通过 Scryfall API 查找卡牌信息。

主要功能点

万智牌套牌管理:
- 上传和管理万智牌套牌列表
- 从套牌中抽牌到手牌
- 查看当前手牌
- 执行调度（mulligan）操作
- 支持备牌更换（sideboarding）
- 重置游戏状态
Scryfall API 集成:
- 通过 Scryfall API 搜索万智牌卡牌
- 获取随机卡牌
- 查询指定卡牌的详细信息

安装步骤

克隆仓库到本地:

git clone https://github.com/artillect/mtg-mcp-servers.git
cd mtg-mcp-servers

设置 Python 虚拟环境:

# 创建并激活虚拟环境
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

安装依赖:

pip install fastmcp httpx

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude 桌面客户端）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以下是针对 'mtg-server' (套牌管理服务器) 和 'scryfall' (Scryfall API 服务器) 的配置示例，请根据您的实际项目路径进行调整：

{
    "mcp_servers": {
        "mtg-server": {
            "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
            "args": [
                "C:\\Path\\To\\Your\\Project\\mtg_server.py"
            ]
        },
        "scryfall": {
            "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
            "args": [
                "C:\\Path\\To\\Your\\Project\\scryfall_server.py"
            ]
        }
    }
}

配置参数说明:

'"mtg-server"' 和 '"scryfall"': 服务器名称，在客户端中用于标识和调用不同的服务器功能。您可以自定义这些名称。
'"command"': Python 解释器的路径。请将其替换为您本地 Python 虚拟环境中的 'python.exe' 可执行文件的完整路径。
'"args"': 启动服务器脚本所需的参数，这里分别是 'mtg_server.py' 和 'scryfall_server.py' 脚本文件的完整路径。请将其替换为您本地项目目录中对应脚本的完整路径。

注意: 请务必将 'C:\Path\To\Your\Project' 替换为您克隆仓库到本地后的实际项目路径。

基本使用方法

配置完成后，启动 Claude 客户端，并确保在客户端设置中启用了您配置的 MCP 服务器。

您可以通过自然语言指令指示 Claude 使用这些服务器的功能。例如：

使用 MTG 套牌管理功能:
- "上传以下套牌列表到 MTG 服务器" (然后粘贴您的套牌列表)
- "从我的套牌中抽 7 张牌"
- "展示我的手牌"
- "调度"
- "备牌更换，移除一张[卡牌A]，加入一张[卡牌B]"
- "重置游戏"
使用 Scryfall API 功能:
- "在 Scryfall 上搜索卡牌 [卡牌名称]"
- "给我一张随机万智牌卡牌"
- "查询卡牌 [卡牌名称] 的信息"

Claude 会将您的指令解析为对 MCP 服务器的工具调用，并将服务器返回的结果呈现给您。

提示: 确保在使用相应功能前，两个服务器 ('mtg-server' 和 'scryfall') 都已在 Claude 客户端中正确配置并运行。

关键词