Love Oracle — Tarot

爱情神谕塔罗牌数据集与 MCP 服务

包含全部 78 张 Rider–Waite–Smith 塔罗牌的爱情与关系关键词，涵盖 22 种语言，以及 奥秘、花色、元素和是／否倾向——提供 JSON 文件，并且提供一个可离线运行的 MCP 服务。 无需注册，可在 CC BY 4.0 许可下免费用于商业用途。

curl -O https://www.loveoracle.app/dataset/love-tarot.json

MCP 服务

三个只读工具，零依赖，零网络调用——所有内容均从本仓库中的 JSON 文件读取。

工具	功能
search_tarot_cards	以 22 种语言中的任意一种按名称查找牌；返回其他工具所需的 slug
get_tarot_card_love_meaning	查询单张牌：正位、逆位、是／否倾向、奥秘、花色、元素
draw_tarot_cards	不重复抽取 1–10 张牌，每张牌逆位概率约为 30%，并附上爱情含义

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

也可以从克隆的仓库运行——无需安装任何东西：

node server.js

也可以使用 Docker：

docker build -t love-oracle-tarot . && docker run -i --rm love-oracle-tarot

想要更详细的解读？ 数据集中不包含这些内容，因此此处不会提供。 关于一张牌代表某人的感受、对前任意味着什么，以及最常见的爱情问题的答案，都可在网站上查看—— 也可通过托管的 MCP 服务访问： https://www.loveoracle.app/api/mcp（Streamable HTTP，无需身份验证），并已列入官方注册表： app.loveoracle/tarot。

市面上已有公开的塔罗牌数据集，但我们找到的全都只有英文版本。这个数据集包含 1,716 组关键词，涵盖 en, es, pt, fr, de, it, nl, da, no, fi, pl, hu, tr, ru, ja, ko, zh, zh-TW, th, vi, id, hi——这是没人想从头重做的那部分。

数据结构

{
  "slug": "the-lovers",
  "name": "The Lovers",
  "arcana": "major",
  "number": 6,
  "suit": null,
  "element": null,
  "yes_no": { "upright": "yes", "reversed": "no" },
  "image": "https://www.loveoracle.app/deck/the-lovers.webp",
  "url": "https://www.loveoracle.app/cards/the-lovers",
  "love": {
    "en": { "name": "The Lovers", "upright": "deep union, a real choice of the heart",
            "reversed": "disharmony, misaligned values, avoidance of choice" },
    "ja": { "name": "恋人たち", "upright": "深い結びつき、心からの選択",
            "reversed": "不調和、ずれた価値観、選ぶことからの逃避" }
  }
}

字段	说明
slug	稳定标识符，始终使用英文名称，永不更改。请将其用作键
arcana / number / suit	major 为 0–21，minor 为 1–14（11 为侍从，12 为骑士，13 为王后，14 为国王）
element	仅适用于花色——water、fire、air、earth。所有大阿尔卡那均为 null，这是有意为之：金色黎明、马赛和现代流派对它们的元素归属各有不同，与其将有争议的说法当作事实，我们宁愿留空
yes_no	单张牌是／否抽牌的倾向。牌变为逆位时，倾向也会反转
image	1909 年的扫描图。全球属于公有领域，不附带任何条件
love.<lang>	本地化牌名，以及正位和逆位关键词

jq '.cards[] | select(.slug=="the-lovers") | .love.es' love-tarot.json
jq -r '.cards[] | select(.yes_no.upright=="yes") | .slug' love-tarot.json   # the 43 "yes" cards

两点注意事项

• 这些关键词专为爱情与关系问题编写，并非用于一般占卜。以职业为重点的应用会需要不同的措辞。
• 21 种非英语语言均由机器从英文源文本翻译而来，未经母语者审校。结构和覆盖范围可靠——没有缺失行，也没有静默回退到英文的情况。泰语和越南语的表达是否地道则未必。欢迎提交修正：创建 issue 或发送邮件至 [email protected]。

许可

CC BY 4.0。可用于商业用途、修改并发布。 唯一条件是注明出处：

Tarot data from Love Oracle — https://www.loveoracle.app
CC BY 4.0

牌面艺术作品采用 Pamela Colman Smith 的 1909 年版本，在全球属于公有领域，不附带任何条件。

其他资源

• 标准文件，始终保持最新： https://www.loveoracle.app/dataset/love-tarot.json
• 文档： https://www.loveoracle.app/dataset
• MCP 服务（Streamable HTTP，只读，无需身份验证）：https://www.loveoracle.app/api/mcp — 提供三个工具：search_tarot_cards、get_tarot_card_love_meaning、get_love_question_answer
• Markdown： 每个公开页面都支持 Accept: text/markdown，也可以直接获取 /md/<path>

curl -H "Accept: text/markdown" https://www.loveoracle.app/cards/the-lovers
curl https://www.loveoracle.app/md/es/cards/the-lovers

此处不包含的内容

每张牌的详细解读——例如它代表某人的感受、它对前任意味着什么，以及常见问题——都留在牌面页面上。此代码仓库是精简的事实层。

---

本项目与 Love Oracle 同步维护。Love Oracle 是一款用于解答爱情问题的 AI 塔罗阅读工具。如果你用它来构建项目，我们很乐意看看。