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显示。
• 所有查询均为不区分大小写的。
• 可以在单个查询中组合多个筛选条件。