lorcana-oracle

lorcana-oracle

Disney Lorcana TCG MCP 服务——由 LorcanaJSON 提供支持的卡牌搜索、牌组分析和系列浏览工具。

功能

• search_cards —— 按名称、规则文本、墨水颜色、类型、稀有度、系列或费用范围搜索卡牌
• browse_sets —— 列出所有系列，或深入查看指定系列中的卡牌
• character_versions —— 比较角色在不同系列中的所有印刷版本
• browse_franchise —— 按迪士尼特许系列浏览卡牌（如《冰雪奇缘》《海洋奇缘》等）
• analyze_ink_curve —— 分析牌组列表的墨水费用分布、可注墨比例和颜色平衡
• analyze_lore —— 分析牌组中的传说值生成情况，或查找传说值生成能力最强的卡牌
• find_song_synergies —— 查找能演唱某首歌曲的角色，或查找某个角色能演唱的歌曲

安装

快速开始

npx lorcana-oracle

软件包中已包含卡牌数据（约 2,710 张卡牌）。无需下载或 API 密钥。

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "lorcana-oracle": {
      "command": "npx",
      "args": ["-y", "lorcana-oracle"]
    }
  }
}

Claude Code

claude mcp add lorcana-oracle -- npx -y lorcana-oracle

工具

search_cards

按名称、规则文本或筛选条件（墨水颜色、类型、稀有度、系列、费用范围）搜索 Disney Lorcana 卡牌。返回分页结果。

search_cards({ query: "Elsa", color: "Amethyst" })
search_cards({ type: "Song", cost_max: 3 })
search_cards({ query: "draw a card", rarity: "Legendary" })

browse_sets

列出所有 Disney Lorcana 系列，或深入查看指定系列的元数据和卡牌。

browse_sets({})
browse_sets({ set_code: "1" })

character_versions

显示 Disney Lorcana 角色在不同系列中的所有印刷版本。适用于比较同一角色的不同版本。

character_versions({ character_name: "Elsa" })
character_versions({ character_name: "Mickey Mouse" })

browse_franchise

按特许系列（故事）浏览 Disney Lorcana 卡牌。不指定特许系列名称时，会列出所有特许系列及其卡牌数量；指定名称时，会显示卡牌和统计数据。

browse_franchise({})
browse_franchise({ franchise: "Frozen" })

analyze_ink_curve

分析 Disney Lorcana 牌组列表的墨水费用分布、可注墨比例和颜色平衡。粘贴牌组列表即可获取曲线分析。

analyze_ink_curve({ deck_list: "4 Elsa - Snow Queen\n4 Let It Go\n2 Hades - King of Olympus" })

analyze_lore

分析牌组列表中的传说值生成情况，或查找传说值生成能力最强的卡牌。在牌组模式下，会显示传说值潜力总量和效率排名；在查询模式下，会显示传说值生成能力最强的卡牌，并可选择添加筛选条件。

analyze_lore({ deck_list: "4 Elsa - Snow Queen\n4 Mickey Mouse - Brave Little Tailor" })
analyze_lore({ color: "Amber", min_lore: 3 })

find_song_synergies

查找 Disney Lorcana 歌曲协同效果。输入一首歌曲，可查找能演唱它的角色；输入一个角色，可查找该角色能演唱的歌曲。不输入内容时，可浏览所有歌曲及演唱者数量。

find_song_synergies({ card_name: "Let It Go" })
find_song_synergies({ card_name: "Elsa - Snow Queen" })
find_song_synergies({})

数据来源

卡牌数据来源于 LorcanaJSON（MIT 许可证）。LorcanaJSON 提供所有已发行 Disney Lorcana 系列的全面卡牌数据。

Disney Lorcana 是 Ravensburger 的产品。本项目与 Ravensburger 或 The Walt Disney Company 无关联，也未获得其认可。卡牌数据的使用遵循 Ravensburger Community Code Policy。

许可证

MIT