b736f1.js","1508","static/chunks/1508-abbc58115cbb4fd0.js","6125","static/chunks/6125-6f7cbc86df4f2503.js","7771","static/chunks/7771-66979ce602088329.js","7660","static/chunks/7660-f5d56ac6a9ee6cc8.js","4147","static/chunks/4147-ef3df161a800b88b.js","9783","static/chunks/9783-e1d5b54e9718b38b.js","8084","static/chunks/8084-f1229cc5d0501fe0.js","2024","static/chunks/2024-e03e13f5faa34f45.js","7796","static/chunks/app/%5Blocale%5D/(default)/server/%5Bname%5D/%5Bauthor_name%5D/page-c3a3facf548ee943.js"],"default"] 24:T16fa,# MCP Server MTG Assistant A Model Context Protocol server that provides Magic: The Gathering card information fetching capabilities using the Scryfall API. ### Example Rules Question Workflow While primarily used for looking up specific card details, this server can also be a crucial first step in answering MTG rules questions. **User Query:** "If I cast a Finale of Devastation with X=10 and search for an Avenger of Zendikar, do the tokens also get +10/+10 and haste, or not?" ![Example Interaction](example.png) ### Available Tools - `get_mtg_card_info` - Retrieves details for a specific Magic: The Gathering card from Scryfall. - `query` (string, required): The search query string (e.g., card name, partial name, characteristics). ## Installation and Running This project uses [`uv`](https://docs.astral.sh/uv/) for dependency management and running scripts. ### Using uv (recommended) Ensure `uv` is installed. You can run the server directly from the project directory: ```bash # Navigate to the project root directory first cd path/to/mcp-servers/mcp-mtg-assistant # Install dependencies (if needed) and run the server script uv run mcp-server-mtg-assistant ``` ### Using PIP (for distribution or alternative setup) If the package were published, you could install it via pip: ```bash pip install mcp-server-mtg-assistant ``` After installation, you could run it as a script: ```bash python -m mcp_server_mtg_assistant ``` For development, you typically run it using `uv run` as shown above. ## Configuration ### Configure for MCP Clients (e.g., Claude.app, Inspector) Add an entry to your client's MCP server configuration. The exact key (`"mtg-assistant"` in the examples) can be chosen by you. **Important:** The configuration needs to point `uv` to the correct project directory using the `--directory` argument. The path style (`/` vs `\`) depends on your operating system and how you run `uv`.

Default: Using uv Directly (Linux/macOS/WSL)

This is the standard approach if your MCP client and the server run in the same Linux, macOS, or WSL environment. ```json // Example for mcp.json or Claude settings "mcpServers": { "mtg-assistant": { "command": "uv", "args": [ "--directory", "/path/to/mcp-servers/mcp-mtg-assistant", // Unix-style path "run", "mcp-server-mtg-assistant" ] } } ```

Windows Client + WSL Server

This configuration is **recommended** if your MCP client runs on **Windows**, but you want the server to execute within **WSL** It uses `wsl.exe` to invoke `uv` inside WSL. **Requirements:** * `uv` must be installed *inside* your WSL distribution. * Adjust the path to `uv` inside WSL (e.g., `/home/user/.cargo/bin/uv`) if it's not in the WSL `PATH`. * Use the `/mnt/...` style path for the `--directory` argument accessible from within WSL. ```json // Example for mcp.json or Claude settings on Windows "mcpServers": { "mtg-assistant": { "command": "wsl.exe", "args": [ "/home/your-user/.cargo/bin/uv", // uv WSL PATH "--directory", "/mnt/d/repos/mcp-servers/mcp-mtg-assistant", // WSL-style path to project "run", "mcp-server-mtg-assistant" ] } } ```

Alternative: Using uv Directly on Windows

This assumes `uv` is installed directly on Windows and your MCP client also runs directly on Windows. * Use the Windows-style path (`D:\...`) for the `--directory` argument. * Be mindful of pote