Ptcg MCP

🚀 《ポケモン》TCGカード検索MCP

このモデルコンテキストプロトコル（MCP）サーバーにより、ClaudeがポケモンTrading Card Gameのカードを検索して表示できるようになります。

📦 インストール

1. Claudeの設定ファイルを更新します：

   • /Users/ABSOLUTE_PATH_HERE/Library/Application Support/Claude/claude_desktop_config.json を開きます。

   • 以下の設定を追加します（既存のMCP設定はすべて削除します）：

     {
       "mcpServers": {
        "ptcg-mcp": {
          "command": "node",
          "args": ["ABSOLUTE_PATH_HERE/dist/index.js"]
        }
       }
     }
     

2. Claudeを終了します：

   • タスクマネージャーを開きます。
   • Claudeを見つけて完全に終了します。

3. Claudeを再起動します：

   • ポケモンTCGカード検索MCPが自動的に読み込まれます。
   • これでClaudeにポケモンカードに関する質問をすることができます。

💻 使用例

設定が完了したら、Claudeに以下のようなポケモンカードに関する質問をすることができます：

• "無料で撤退できる標準ルールの基本ポケモンを表示"
• "HPが120を超える水属性のポケモンを探す"
• "Pikachuのカードを検索"

Claudeは一致するカードとその画像、関連情報を表示します。

✨ 主な機能

• 名前、タイプ、サブタイプ、合法性などの条件でカードを検索できます。
• 高解像度のカード画像を表示できます。
• 様々なカード属性でフィルタリングできます：
  • 名前（完全一致 ! とワイルドカード * をサポート）
  • サブタイプ（例：基本、EX、GX、V、VMAXなど）
  • 合法性（標準、拡張、無制限）
  • タイプ（水、火、草など）
  • 撤退コスト
  • HP
  • 全国図鑑番号
  • その他！

💻 使用例

以下は試すことができるサンプルクエリです：

• "無料で撤退できる標準ルールの基本ポケモンを表示"
• "HPが120を超える水属性のポケモンを探す"
• "名前が 'char*' のカードを検索"
• "標準フォーマットで禁止されているカードを表示"
• "Charmanderから進化したEXポケモンを探す"

📚 ドキュメント

名前検索

• 通常の検索：name:pikachu
• 完全一致：!name:pikachu
• ワイルドカード：name:char*
• ハイフンを保持：name:chien-pao

フィルター

• タイプ：types:water または -types:water（除外）
• サブタイプ：subtypes:basic
• 合法性：legalities.standard:legal
• HP：hp:[100 TO 200]
• 撤退コスト：convertedRetreatCost:0

範囲クエリ

[ と ] で範囲を含め、{ と } で範囲を除外します：

• hp:[100 TO 200] - HPが100から200の間（境界を含む）
• hp:{100 TO 200} - HPが100から200の間（境界を含まない）
• hp:[* TO 100] - HPが100以下
• hp:[100 TO *] - HPが100以上

📚 ドキュメント

MCPは以下のカード情報を返します：

• カード名
• シリーズ名
• 高解像度のカード画像
• カードの合法性
• その他要求されたカード詳細

🔧 技術詳細

• MCPはポケモンTCG APIを使用してカードデータを取得します。
• 画像はポケモンTCG APIのCDNから直接表示されます。
• すべてのクエリは大文字小文字を区別しません。
• 単一のクエリで複数のフィルター条件を組み合わせることができます。