Magic: The Gathering

🚀 Magic: The Gathering MCP Tool Server

This is a Model Context Protocol (MCP) server for accessing Magic: The Gathering card data, rules, and set information. It provides quick access to card details, rulings, comprehensive rule sections, and more.

🚀 Quick Start

This MCP server allows you to access Magic: The Gathering card data, rules, and set information. After setting up the server, you can use an MCP client (e.g., Claude Desktop) to access the relevant content.

✨ Features

• Search for Magic cards by name, color, type, and other criteria.
• View detailed card information, including rulings and foreign language versions.
• Access the Magic: The Gathering comprehensive rules.
• Browse set information and card lists.
• View card images (if available).

📦 Installation

Installation Requirements

1. PHP 8.1 or higher
   • Check the version by running php --version.
   • If you need to download it, visit php.net.
2. Composer (PHP dependency management tool)
   • Download from getcomposer.org.

Setup Instructions

1. Clone this repository:

git clone https://github.com/james2037/mcp-gatherer.git

2. Navigate to the project directory:

cd mcp-gatherer

3. Install dependencies:

composer install

💻 Usage Examples

Basic Usage

To start the server, your MCP client (e.g., Claude Desktop) can use the following command:

php path/to/mcp_server.php

After the server starts, you can start using the Magic: The Gathering tools through the MCP client. Specify the STDIO transport if necessary.

Advanced Usage

An example claude_desktop_config.json for Windows users might look like this:

{
  "mcpServers": {
    "mcp-gatherer": {
      "command": "php",
      "args": ["C:\\mcp-gatherer\\mcp_server.php"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

📄 License

This project is released under the MIT License. For more details, see the LICENSE file.

💪 Contribution

If you'd like to contribute to the development of this tool, feel free to submit issues or pull requests. For major changes, please open an issue first to discuss what you'd like to change.