
Disney Lorcana MCP
io.github.danielenricocahall由 GitHub 账号 danielenricocahall 发布v2.5.1更新于 Oct 24, 2026
MCP server for Disney Lorcana TCG: card search, deck validation, stats, and deck import/export
概览
非官方的迪士尼洛卡纳卡牌服务器,让助手搜索卡牌、分析统计数据,并校验或导入导出牌组。
- 可以做什么
- 按名称、颜色、费用、稀有度、类型、关键词、属性、系列和牌面文本搜索、计数和汇总卡牌,支持模糊名称匹配和特性列表。按赛制规则校验牌组,例如最低张数、同名张数上限和墨水限制。计算牌组统计:费用曲线、颜色分布、可注墨数量、类型与关键词细分。以 Dreamborn/Pixelborn 兼容的文本格式导入和导出牌组列表。报告服务器状态和卡牌数量。
- 适用场景
- 适合构建或检查迪士尼洛卡纳牌组、查询卡牌详情与能力,或用自然语言回答关于卡池、费用曲线和关键词分布的问题。
- 运行要求
- 通过 stdio 在本地运行;可用 uvx 或 pipx(Python)安装,或运行已发布的 Docker 镜像。无需 API 密钥或账号。启动时会通过网络获取卡牌快照,除非本地已有缓存文件;缓存路径和获取行为由 LORCANA_CACHE_PATH、LORCANA_REFRESH_ON_STARTUP 等环境变量控制。
安装
在 SourceWeft 中
- 打开 控制台中的 Disney Lorcana MCP,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
Disney Lorcana MCP Server
An MCP server that lets Claude (or any MCP client) search, analyze, and build decks for the Disney Lorcana TCG. Ask for cards in plain English, get rules-checked deck validation, ink curves and keyword breakdowns, and round-trip deck lists with Dreamborn/Pixelborn.
2,506 unique cards (3,192 printings including alternate arts and promos), refreshed daily. No API key, no database, no rate limits — the server ships against a snapshot published from our own pipeline, so it never depends on a third-party API being up at query time.
Tools
Install
uvx (recommended — no clone, no Docker)
Claude Desktop / claude_desktop_config.json:
Claude CLI:
pip / pipx
Docker
The server is also published to GHCR and the MCP Registry.
To persist the card cache across container restarts, mount a volume:
From a clone
No port is exposed; MCP communication is over stdio.
Example questions
Once connected to an MCP client, you can ask natural language questions like:
Card lookup
- "Show me all cards named Moana"
- "What does the card Maui - Hero to All do?"
- "Find all legendary amber cards"
Deck building
- "What are the cheapest ruby characters with at least 3 strength?"
- "Show me inkable sapphire cards that cost 4 or less"
- "Find steel characters with 5 or more willpower"
- "What 3-lore characters exist in emerald?"
Keyword & ability search
- "How many Singer cards cost exactly 5?"
- "How many Evasive characters are there in the first set?"
- "How many ruby cards have Reckless?"
- "Find all cards with Ward in their text"
- "Show me Shift cards in amethyst"
Stats & aggregations
- "How many cards are in each set?"
- "What's the color distribution across all cards?"
- "What are the most common traits?"
- "Show me the ink curve — how many cards exist at each cost?"
- "How many legendary cards are inkable?"
Cross-filter queries
- "How many amber characters have 3 or more lore?"
- "Find cheap (cost 2-3) characters with high strength (4+) in steel"
- "How many cards in set 1 have Evasive and cost less than 4?"
Note: For plain keyword queries (Evasive, Bodyguard, Shift, etc.) use the
keywordparameter — it filters against the structured ability list and is more reliable than substring search. For value-specific queries likeSinger 5orResist +2, usebody_text(keyword values live in the card's full text, not the ability list).
MCP prompts
build_deck(colors, playstyle="balanced")— guides the model through assembling a legal Lorcana deck (60-card minimum, ≤2 inks, max 4 copies of any card) for the requested color(s) and playstyle (aggressive/control/lore-race/balanced). Uses the search/aggregate tools above plus the rules embedded in the server instructions.
Card data & startup behavior
On startup, the server fetches a JSON list of cards from
https://danielenricocahall.github.io/lorcana-mcp/allCards.json. The snapshot is refreshed daily
by data_pipeline/fetch_cards.py, which pulls from the Lorcast API,
normalizes each card into our internal schema, and publishes the list to the gh-pages branch.
That middle layer insulates running servers from Lorcast's availability and rate limits — the
runtime never calls Lorcast directly.
Cards are kept in memory as a Python list for fast filtering. The dataset holds 2,506 unique
cards, each carrying a printings array for its alternate sets, numbers, and rarities (3,192
printings in total). Consolidating printings onto one row per card means a search for "Elsa"
returns each distinct Elsa once rather than repeating her for every promo reprint. A local JSON
file cache (LORCANA_CACHE_PATH, default cards.json) lets the server skip the network fetch on
subsequent startups.
Config
LORCANA_API(default:https://danielenricocahall.github.io/lorcana-mcp/allCards.json)LORCANA_CACHE_PATH(default:cards.json) — local file for caching fetched cardsLORCANA_HTTP_TIMEOUT_SECONDS(default:60)LORCANA_REFRESH_ON_STARTUP(default:false) —truealways fetches and repopulates storageLORCANA_SKIP_IF_DB_EXISTS(default:true) —falsefetches and repopulates even if the cache is populated
TOON response format
search_cards accepts a response_format argument:
"json"(default) — list of card objects, unchanged from prior versions."toon"— a TOON string with one column header line and one row per card, encoded by thetoonsRust-backed library (the official community reference implementation).
Example (search_cards(name="elsa", limit=2, response_format="toon")):
The outer cards[2]: falls back to YAML-style per-card blocks (rather than a single tabular table) because card shapes vary — Actions and Items don't carry strength/willpower/lore, for example. The inner printings[N]{...}: block is fully tabular since every printing has the same four fields.
Benchmark
Measured with benchmarks/bench_toon.py against the live 2,506-card dataset, tokenizing with
tiktoken cl100k_base (used as a proxy for Claude's tokenizer):
Note: TOON's relative savings are smaller here than they were before the printings consolidation
(pre-PR-#29 the same queries showed ~50% reductions). That gap is structural to the nested
printings array — TOON's columnar encoding wins on the top-level fields but falls back to
JSON-style encoding inside the per-printing entries, so the array dilutes the relative gain.
Absolute token counts are still down meaningfully versus the equivalent count of pre-consolidation
rows, since each unique card is now represented once with a small printings list rather than as
1-3 separate full rows.
Reproduce with PYTHONPATH=. uv run python benchmarks/bench_toon.py (requires a populated
cards.json cache).
Disclaimer
This is a personal, unofficial fan and engineering project. It is not affiliated with, endorsed by, sponsored by, or reviewed by Disney, Ravensburger, or the Disney Lorcana TCG team. It is built and distributed in accordance with Ravensburger's Disney Lorcana TCG Community Code, using only publicly available and community data sources. All Disney Lorcana TCG names, card text, trademarks, and related intellectual property belong to Disney and Ravensburger. This project is non-commercial and reflects my personal views only, not those of my employer.
MCP Registry ownership verification — the registry reads this line from the published package description to confirm this project owns the server name.
mcp-name: io.github.danielenricocahall/lorcana-mcp
来源:README.md,提交 88c1ae1
工具
0版本历史
1- v2.5.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分