iwantmymtg-mcp

iwantmymtg-mcp

I Want My MTG 用の MCP サーバーです。IWMM の API をツールとして公開し、Claude Desktop、Claude Code、Cursor などの MCP クライアントから、Magic: The Gathering のカードやセットを検索したり、ユーザーのコレクションを会話形式で管理したりできます。

npm、MCP Registry、Smithery で公開されています。API に合わせて対応範囲を拡大しています。常に最新のツール一覧は docs/TOOLS.md をご覧ください。

できること

• 匿名（キー不要）： カードの検索、セットと番号によるカードの検索、現在価格と過去30日間の価格履歴の取得、カードの買取（ベンダーへの売却）オファーの取得、セットと収録カードの一覧表示、未開封製品の一覧表示。
• 認証済み（IWMM API キーが必要）： 在庫と取引の管理、デッキの作成・管理（作成、デッキリストからのインポート、カードの編集、不足しているカードの買い物リストへの追加）、ポートフォリオの概要、履歴、パフォーマンス、キャッシュフロー、実現利益、内訳（色別を含む。各項目の詳細表示も可能）の確認、価格アラートと通知の管理。
• 売却ツール（キーが必要）： コレクションの市場売却価格（カードごとの最良買取オファーをベンダー別に集計）の確認、買い物リスト（欲しいものリスト）の管理、買い物リストに向けて売却する際の現金とストアクレジットのどちらが有利かの提案取得。

今後の予定については、プロジェクトのロードマップをご覧ください。

インストール

Node 20 以降が必要です。

npx iwantmymtg-mcp

お好みに応じて、グローバルにインストールすることもできます。

npm install -g iwantmymtg-mcp
iwantmymtg-mcp

Claude Desktop

claude_desktop_config.json に追加します（macOS：~/Library/Application Support/Claude/claude_desktop_config.json、Windows：%APPDATA%\Claude\claude_desktop_config.json）。

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": {
        "IWMM_API_KEY": "iwm_live_..."
      }
    }
  }
}

IWMM_API_KEY は任意です。読み取り専用ツールはキーなしで利用できます。https://iwantmymtg.net/user/api-keys でキーを作成してください。

Claude Code

プロジェクト内の .mcp.json（またはグローバル設定の ~/.claude/.mcp.json）に追加します。

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": { "IWMM_API_KEY": "iwm_live_..." }
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル設定）またはプロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": { "IWMM_API_KEY": "iwm_live_..." }
    }
  }
}

保存後、Cursor を再起動し、Settings -> Features -> MCP Servers に iwmm が表示されることを確認してください。

プロンプトの例

• 「Lightning Bolt の版を検索して、一番安いものを教えてください。」
• 「Modern Horizons 3 の Bloodbraid Elf の価格履歴を教えてください。」
• 「Lightning Bolt LEA を4枚、在庫に追加してください。」
• 「MH3 の未開封製品には何がありますか？」
• 「今コレクションを売るといくらになり、どのベンダーが一番高く買い取ってくれますか？」
• 「これらのカードを買い物リストに追加して、現金とストアクレジットのどちらがお得か教えてください。」

よくある操作の手順については examples/ を、ツールの完全なリファレンスについては docs/TOOLS.md をご覧ください。

設定

環境変数	デフォルト	用途
IWMM_API_KEY	(未設定)	個人用 API キー。認証が必要なツールでのみ必要です。
IWMM_BASE_URL	https://iwantmymtg.net	セルフホストまたはローカル開発用の IWMM インスタンスの URL を上書きします。

ローカル開発

npm install
npm run build
node dist/index.js

ライブリロードを使う場合は、tsx を使用します。

npm install
npx tsx src/index.ts

ライセンス

このプロジェクトは MIT ライセンスで公開されています。詳細は LICENSE ファイルをご覧ください。