MTG Assistant

MCP サーバー MTG アシスタント

Scryfall API を使用して、Magic: The Gathering のカード情報を取得する機能を提供する Model Context Protocol サーバーです。

ルールに関する質問のワークフロー例

主に特定のカードの詳細を調べるために使用しますが、このサーバーは MTG のルールに関する質問に答える際の重要な最初のステップにもなります。

ユーザーの質問：「X=10 で Finale of Devastation を唱えて Avenger of Zendikar を探した場合、トークンにも +10/+10 と速攻が付与されますか？それとも付与されませんか？」

利用可能なツール

• get_mtg_card_info - Scryfall から特定の Magic: The Gathering カードの詳細を取得します。
  • query（文字列、必須）：検索クエリ文字列（例：カード名、部分的な名前、特性）

インストールと実行

このプロジェクトでは、依存関係の管理とスクリプトの実行に uv を使用します。

uv を使用する（推奨）

uv がインストールされていることを確認してください。プロジェクトディレクトリからサーバーを直接実行できます。

# 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

PIP を使用する（配布または別のセットアップ方法）

パッケージが公開されていれば、pip を使用してインストールできます。

pip install mcp-server-mtg-assistant

インストール後、スクリプトとして実行できます。

python -m mcp_server_mtg_assistant

開発時は、上記のように通常 uv run を使用して実行します。

設定

MCP クライアント用の設定（例：Claude.app、Inspector）

クライアントの MCP サーバー設定にエントリを追加します。キー（例では "mtg-assistant"）は任意に指定できます。

重要： --directory 引数を使って、uv が正しいプロジェクトディレクトリを参照するよう設定する必要があります。パスの形式（/ または \）は、オペレーティングシステムと uv の実行方法によって異なります。

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

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

// Example for mcp.json or Claude settings on Windows
"mcpServers": {
  "mtg-assistant": {
    "command": "uv",
    "args": [
      "--directory",
      "D:\path\to\mcp-servers\mcp-mtg-assistant", // Windows-style path
      "run",
      "mcp-server-mtg-assistant"
    ]
  }
}

.venv の競合への対処（異なる環境）

• 問題： uv run は、オペレーティングシステムや環境（例：Linux と Windows）ごとに異なる .venv ディレクトリを作成します。Windows でサーバーを直接実行する方法と、WSL（またはネイティブの Linux）経由で実行する方法を切り替えると、既存の .venv に互換性がない場合があります。
• 解決策： 環境を切り替える前に、mcp-mtg-assistant プロジェクトのルートにある .venv ディレクトリを削除してください。その後 uv run を実行すると、使用中の環境に適した新しい .venv が作成されます。

デバッグ

設定に記載したコマンドと引数の前に npx @modelcontextprotocol/inspector を付けることで、MCP Inspector を使用してサーバーをデバッグできます。

# Example using the Default (Linux/macOS/WSL) configuration:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-servers/mcp-mtg-assistant run mcp-server-mtg-assistant

# Example using the Recommended (Windows Client + WSL Server) configuration:
npx @modelcontextprotocol/inspector wsl.exe /home/your-user/.cargo/bin/uv --directory /mnt/d/repos/mcp-servers/mcp-mtg-assistant run mcp-server-mtg-assistant

# Example using the Alternative (Direct Windows) configuration:
npx @modelcontextprotocol/inspector uv --directory D:\path\to\mcp-servers\mcp-mtg-assistant run mcp-server-mtg-assistant

貢献

この MTG アシスタント MCP サーバーの拡張と改善に役立つ貢献を歓迎します。新機能の追加、既存機能の強化、ドキュメントの改善など、どのようなご意見も貴重です。

他の MCP サーバーや実装パターンの例については、以下を参照してください。 https://github.com/modelcontextprotocol/servers

プルリクエストを歓迎します。新しいアイデア、バグ修正、機能強化をぜひお寄せください。

ライセンス

mcp-server-mtg-assistant は MIT ライセンスの下でライセンスされています。MIT ライセンスの条項および条件に従う限り、このソフトウェアを自由に使用、変更、配布できます。