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

已驗證STDIO僅桌面

概覽

AI 產生的概覽

非官方的迪士尼洛卡納卡牌伺服器,讓助理搜尋卡牌、分析統計資料,並驗證或匯入匯出牌組。

可以做什麼
依名稱、顏色、費用、稀有度、類型、關鍵字、屬性、系列和牌面文字搜尋、計數和彙總卡牌,支援模糊名稱比對和特性清單。依賽制規則驗證牌組,例如最低張數、同名張數上限和墨水限制。計算牌組統計:費用曲線、顏色分布、可注墨數量、類型與關鍵字細分。以 Dreamborn/Pixelborn 相容的文字格式匯入和匯出牌組清單。回報伺服器狀態和卡牌數量。
適用情境
適合建立或檢查迪士尼洛卡納牌組、查詢卡牌詳情與能力,或用自然語言回答關於卡池、費用曲線和關鍵字分布的問題。
執行需求
透過 stdio 在本機執行;可用 uvx 或 pipx(Python)安裝,或執行已發布的 Docker 映像。不需要 API 金鑰或帳號。啟動時會透過網路取得卡牌快照,除非本機已有快取檔案;快取路徑和取得行為由 LORCANA_CACHE_PATH、LORCANA_REFRESH_ON_STARTUP 等環境變數控制。
安裝前請注意
卡牌資料在啟動時從第三方託管的快照取得,因此除非已有快取,伺服器會連線至該主機。牌組匯入匯出只產生文字,不會傳送到 Dreamborn 或 Pixelborn。屬非官方愛好者專案,與 Disney 或 Ravensburger 無關。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Disney Lorcana MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Disney Lorcana MCP Server

[MCP Badge]

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

ToolWhat it does
search_cardsFilter and retrieve cards by name, color, cost, rarity, type, keyword, stats, set, and body text. Supports response_format="toon" for ~10% fewer tokens
count_cardsCount cards matching a filter without paying for the card objects
aggregate_cardsGroup counts by cost (ink curve), rarity, color, set_code, or type
resolve_cardFuzzy-match an informal, partial, or misspelled card name to the closest cards
top_traitsMost common traits (Storyborn, Hero, Villain, Ally, ...) across all cards
validate_deckCheck a deck against format rules (≥60 cards, max 4 copies, ≤2 inks, dual-ink requirements); returns {legal, total_cards, inks, violations}
deck_statsInk curve, color split, inkable count, type breakdown, keyword counts, subtype counts, and per-card keyword tags
import_deckParse a Dreamborn/Pixelborn deck list into resolved cards, with fuzzy candidates for unresolved lines
export_deckRender a deck back out as a Dreamborn/Pixelborn-compatible text list
server_statusStartup metadata (card count, configuration)

Install

uvx (recommended — no clone, no Docker)

bash
uvx lorcana-cards-mcp

Claude Desktop / claude_desktop_config.json:

json
{  "mcpServers": {    "lorcana": {      "command": "uvx",      "args": ["lorcana-cards-mcp"]    }  }}

Claude CLI:

bash
claude mcp add --scope user -- lorcana uvx lorcana-cards-mcp

pip / pipx

bash
pipx install lorcana-cards-mcp   # then run: lorcana-cards-mcp

Docker

The server is also published to GHCR and the MCP Registry.

bash
docker run --rm -i ghcr.io/danielenricocahall/lorcana-mcp:latest
json
{  "mcpServers": {    "lorcana": {      "command": "docker",      "args": ["run", "--rm", "-i", "ghcr.io/danielenricocahall/lorcana-mcp:latest"]    }  }}

To persist the card cache across container restarts, mount a volume:

bash
docker run --rm -i \  -e LORCANA_CACHE_PATH=/data/cards.json \  -e LORCANA_SKIP_IF_DB_EXISTS=true \  -v lorcana_mcp_data:/data \  ghcr.io/danielenricocahall/lorcana-mcp:latest

From a clone

bash
uv run python main.py
bash
docker build -t lorcana-mcp:latest .docker run --rm -i lorcana-mcp:latest
# or via composedocker compose builddocker compose run --rm -T lorcana-mcp

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 keyword parameter — it filters against the structured ability list and is more reliable than substring search. For value-specific queries like Singer 5 or Resist +2, use body_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 cards
  • LORCANA_HTTP_TIMEOUT_SECONDS (default: 60)
  • LORCANA_REFRESH_ON_STARTUP (default: false) — true always fetches and repopulates storage
  • LORCANA_SKIP_IF_DB_EXISTS (default: true) — false fetches 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 the toons Rust-backed library (the official community reference implementation).

Example (search_cards(name="elsa", limit=2, response_format="toon")):

cards[2]:  - id: crd_01c4835a62df4960bb973aeff81f2bb2    name: Elsa    version: Ice Maker    full_name: Elsa - Ice Maker    cost: 7    ...    printings[3]{set_code,set_name,number,rarity}:      "7",Archazia's Island,69,Super Rare      C2,Lorcana Challenge Year 3,2,Promo      C2,Lorcana Challenge Year 3,6,Promo  - id: crd_04bca46a8e2d4e9ba0fbdbfc6c99e51e    name: Elsa    ...

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):

queryrowsJSON tokensTOON tokensΔ
color="amber", limit=20020044,10139,680−10.0%
color="ruby", limit=505010,5229,519−9.5%
card_type="action", limit=50 (sparse cols)5010,1549,250−8.9%
body_text="when", limit=50 (long full_text)5011,60210,391−10.4%
name="elsa", limit=20143,4882,940−15.7%
total79,86771,780−10.1%

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
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v2.5.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分