Ptcg MCP

🚀 《精靈寶可夢》TCG卡牌查詢 MCP

本模型上下文協議（MCP）服務器可讓Claude搜索並展示精靈寶可夢Trading Card Game（TCG）卡牌，為寶可夢卡牌愛好者提供便捷的查詢服務。

🚀 快速開始

📦 安裝指南

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將顯示匹配的卡牌及其圖像和相關信息。

高級用法

以下是一些更復雜的示例查詢，您可以嘗試：

• "顯示標準格式中的禁卡"
• "查找從Charmander進化而來的EX精靈寶可夢"

✨ 主要特性

• 多條件搜索：可按名稱、類型、子類型、合法性等更多條件搜索卡片。
• 高清圖像查看：支持查看高分辨率卡牌圖像。
• 屬性篩選：可按各種卡牌屬性進行篩選，包括：
  • 名稱：支持精確匹配 ! 和通配符 *，如 name:pikachu、!name:pikachu、name:char*、name:chien - pao。
  • 子類型：例如，基本、EX、GX、V、VMAX等，如 subtypes:basic。
  • 合法性：標準、擴展、無限，如 legalities.standard:legal。
  • 類型：水、火、草等，如 types:water 或 -types:water（排除）。
  • 撤退費用：如 convertedRetreatCost:0。
  • HP：支持範圍查詢，如 hp:[100 TO 200]。
  • 全國圖鑑編號 以及其他更多！

📚 詳細文檔

查詢語法

• 名稱搜索：
  • 正常搜索：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顯示。
• 所有查詢均為不區分大小寫的。
• 可以在單個查詢中組合多個篩選條件。