MCP ExplorerExplorer

Mtg Mcp Servers

@artillecton a year ago
2 MIT
FreeCommunity
AI Systems
Model Context Protocol (MCP) servers for searching for cards with the Scryfall API, and managing the LLM's decklist and hand when playing

Overview

What is Mtg Mcp Servers

mtg-mcp-servers is a project that provides Model Context Protocol (MCP) servers designed for interacting with Magic: The Gathering decks and card information through the Scryfall API.

Use cases

Use cases include uploading and managing MTG deck lists, drawing cards during gameplay, searching for specific cards using the Scryfall API, and retrieving random cards for deck building.

How to use

To use mtg-mcp-servers, clone the repository, set up a Python virtual environment, install dependencies, and configure the servers in your Claude client. You can then interact with the servers to manage your MTG decks and search for card information.

Key features

Key features include MTG Deck Manager functionalities such as uploading decks, drawing cards, managing hands, performing mulligans, and sideboarding, along with Scryfall API integration for card searches and information retrieval.

Where to use

mtg-mcp-servers can be used in gaming environments, particularly for players of Magic: The Gathering who want to manage their decks and card information efficiently.

Content

MTG Deck Manager MCP Servers

This project provides Model Context Protocol (MCP) servers for interacting with Magic: The Gathering decks and card information directly through Claude.

Features

  • MTG Deck Manager: Upload decks, draw cards, manage your hand, perform mulligans, and handle sideboarding
  • Scryfall API Integration: Search for cards, get random cards, and look up card information

Installation

  1. Clone this repository to your local machine:
git clone https://github.com/artillect/mtg-deck-mcp-server.git
cd mtg-deck-mcp-server
  1. Set up a Python virtual environment:
# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate

# Install dependencies
pip install fastmcp httpx

Claude Desktop Client Configuration

Add the following to your Claude config:

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

Make sure to adjust the paths to match your local installation.

Usage

After setting up the servers in your Claude client, you can interact with them by asking Claude to:

  • Upload an MTG deck list
  • Draw cards from your deck
  • View your hand
  • Search for card information via Scryfall
  • Get random cards or search by name

Notes

  • The Scryfall server may occasionally crash due to ongoing development.
  • Make sure both servers are running when you want to use their respective features.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers