返回 MCP 目录
public公开dns本地运行

mtg-mcp-servers

MTG卡牌管理MCP服务

article

README

🚀 MTG 套牌管理器 MCP 服务

该项目提供了模型上下文协议(MCP)服务器,可借助Claude直接与《魔法:牌桌对决》(Magic: The Gathering)的套牌和卡牌信息进行交互,极大地提升了玩家管理套牌和获取卡牌信息的便捷性。

🚀 快速开始

安装步骤

  1. 将此仓库克隆到本地计算机:
git clone https://github.com/artillect/mtg-deck-mcp-server.git
cd mtg-deck-mcp-server
  1. 配置 Python 虚拟环境:
# 创建并激活虚拟环境
python -m venv .venv
.venv\Scripts\activate

# 安装依赖项
pip install fastmcp httpx

Claude 桌面客户端配置

在你的Claude配置中添加以下内容:

{
    "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 套牌管理器:支持上传套牌、抽卡、管理手牌、执行重洗以及处理边板操作,为玩家提供全面的套牌管理功能。
  • Scryfall API 集成:可搜索卡片、获取随机卡片并查询卡牌信息,满足玩家多样化的卡牌信息获取需求。

💻 使用示例

在Claude客户端运行服务器后,你可以通过让Claude执行以下操作:

  • 上传MTG套牌列表
  • 从套牌中抽卡
  • 查看手牌
  • 搜索卡牌信息(通过Scryfall)
  • 获取随机卡片或按名称搜索卡片

⚠️ 注意事项

⚠️ 重要提示

Scryfall 服务器可能会由于持续开发偶尔崩溃。

💡 使用建议

确保两个服务器都在运行,以便使用各自的功能。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端