Tarotoo Tarot

Tarotoo 塔罗牌 MCP 服务

一个 Model Context Protocol 服务，可让 AI 助手（Claude、ChatGPT、Cursor 以及任何其他 MCP 客户端）实时访问 Tarotoo 塔罗牌含义数据集：包含 Rider–Waite–Smith 传统中的全部 78 张牌，以及正位和逆位含义与关键词、正位和逆位的爱情、事业、情绪和灵性解读、行星和星座关联，以及正位和逆位的「是／否」值。

由 Tarotoo 发布：这些牌义正是 Tarotoo.com 上 AI 解读的依据。

快速开始

需要 Node.js ≥ 18。无需安装，客户端通过 npx 运行。

Claude Code

claude mcp add tarotoo-tarot -- npx -y tarotoo-mcp-server

Claude Desktop — 添加到 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "tarotoo-tarot": {
      "command": "npx",
      "args": ["-y", "tarotoo-mcp-server"]
    }
  }
}

Cursor / Windsurf / 其他 MCP 客户端 — 在客户端的 MCP 设置中使用相同的 command/args 配置。

MCP 注册表 — 已列入 io.github.Tarotoo-com/tarotoo-mcp-server，因此支持注册表的客户端可以直接发现并安装。

然后向助手提出类似 “宝剑三对我的事业有什么含义？” 或 “为我抽三张牌” 这样的问题，它便会调用以下工具。

工具

工具	参数	返回内容
get_card_meaning	name（字符串）	单张牌的完整记录，包括含义、关键词、爱情／事业／情绪／灵性解读（正位和逆位）、行星、星座、「是／否」值。牌名匹配较灵活（"fool" → 愚者）
list_cards	arcana?（major/minor）、suit?（wands/cups/swords/pentacles）	牌名，可按条件筛选
search_cards	query（字符串）、limit?（1–78，默认 10）	与主题或关键词匹配的牌，按匹配度从高到低排列，例如 "heartbreak" → 宝剑三
yes_no_answer	name（字符串）	该牌的 yes/no/maybe 值，并以正位含义作为依据
draw_cards	count?（1–10，默认 1）、allow_reversed?（布尔值）	随机抽取互不重复的牌，并提供与牌面方向相对应的含义，用于生成牌阵

示例

tools/call get_card_meaning {"name": "the star"}

{
  "name": "The Star",
  "arcana": "major",
  "element": "Air",
  "planet": "Saturn",
  "zodiac": "Aquarius",
  "yes_no": "yes",
  "yes_no_reversed": "no",
  "keywords_upright": ["hope", "renewal", "healing", "inspiration", "faith"],
  "meaning_upright": "Hope, renewal, healing, inspiration, faith.",
  "love": "hope in love, emotional healing, renewed trust, an inspiring connection",
  "love_reversed": "lost faith, discouragement, disconnection, dimmed hope"
}

每张牌都包含关键词、含义、爱情、事业、情绪、灵性和「是／否」的正位与逆位解读。以上示例经过了简化。

从源代码运行

git clone https://github.com/Tarotoo-com/tarotoo-mcp-server.git
cd tarotoo-mcp-server
npm install
npm test        # 8-check smoke test: full MCP session over stdio
node server.js  # stdio transport

数据集

嵌入的 data/cards.json 基于 tarotoo-tarot-dataset 构建（MIT）。相同数据发布在多个平台：

资源	链接
数据集来源和文档	Tarotoo-com/tarotoo-tarot-dataset
数据集主页	tarotoo.com/open-data
Hugging Face	Tarotoo/tarotoo-tarot-card-meanings
Kaggle	tarotoo-tarot-card-meanings
npm 软件包	tarotoo-tarot
PyPI 软件包	tarotoo-tarot
可引用的 DOI，数据集和论文	10.5281/zenodo.21285777
可引用的 DOI，整个代码库	10.5281/zenodo.21268290
此服务自己的 DOI	10.5281/zenodo.21298382

两个数据集 DOI 均为概念 DOI，始终指向最新版本。

这些解读由 Tarotoo 在莱德–韦特–史密斯传统框架内创作，参考了权威资料（A. E. Waite 的 The Pictorial Key to the Tarot，1911 年；归属依据金色黎明的 Book T）。

许可证

代码和数据集：MIT。欢迎注明来源为 Tarotoo（tarotoo.com）。

预期用途

此数据集用于教育、研究、创作、娱乐和自我反思，不应替代医疗、法律、财务、心理健康或其他专业建议。