Love Oracle — Tarot

ラブ・オラクル・タロットのデータセットとMCP サーバー

22言語で恋愛や人間関係に関するキーワードを収録した、ライダー・ウェイト・スミス版タロット全78枚のデータセットです。アルカナ、スート、元素、イエス／ノーの極性も含まれています。JSONファイルとして、またオフラインで動作するMCP サーバーとして利用できます。登録不要で、CC BY 4.0の下、商用利用も無料です。

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

MCP サーバー

読み取り専用ツールが3つ、依存関係なし、ネットワーク通信なし。このリポジトリのJSONファイルからすべての回答を返します。

ツール	機能
search_tarot_cards	22言語のいずれかでカード名を検索します。他のツールで使用するスラッグを返します
get_tarot_card_love_meaning	1枚のカードについて、正位置、逆位置、イエス／ノーの傾向、アルカナ、スート、元素を返します
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として掲載されています。

公開されているタロットのデータセットはありますが、見つかったものはすべて英語のみでした。このデータセットには、en, es, pt, fr, de, it, nl, da, no, fi, pl, hu, tr, ru, ja, ko, zh, zh-TW, th, vi, id, hiの1,716組のキーワードが収録されています。誰もやり直したくない作業を、すでに済ませてあります。

データ構造

{
  "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	1枚引きでイエス／ノーを占う際の極性です。カードが逆位置の場合は反転します
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

あらかじめお伝えしておきたい2点

• これらのキーワードは、一般的な占いではなく、恋愛や人間関係に関する質問向けに書かれています。 キャリアに焦点を当てたアプリでは、別の表現が必要になります。
• 英語以外の21言語は、英語の原文から機械翻訳したもので、ネイティブスピーカーによるレビューは受けていません。 構造と収録範囲は信頼できます。欠落した行や、気づかれないまま英語にフォールバックする箇所はありません。ただし、タイ語とベトナム語の慣用表現は適切でない場合があります。修正を歓迎します。issueを作成するか、[email protected]までメールでお知らせください。

ライセンス

CC BY 4.0。商用利用、改変、配布が可能です。必要な条件はクレジット表記だけです。

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

カードの絵は、パメラ・コールマン・スミスによる1909年版のもので、世界中でパブリックドメインです。利用条件はありません。

こちらもご利用いただけます

• 常に最新の正規ファイル： https://www.loveoracle.app/dataset/love-tarot.json
• ドキュメント： https://www.loveoracle.app/dataset
• MCP サーバー（Streamable HTTP、読み取り専用、認証不要）：https://www.loveoracle.app/api/mcp — 3つのツール：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

ここに含まれていないもの

各カードが誰かの気持ちを示す場合の意味や、元恋人について何を示しているかといった詳しい解釈、よくある質問は、カードのページに掲載されています。このリポジトリは、簡潔な事実情報をまとめたものです。

---

恋愛の質問に答える AI タロットリーダー、Love Oracle とともにメンテナンスされています。これを使って何かを作ったら、ぜひ見せてください。