Tarotoo Tarot

Tarotoo Tarot MCP サーバー

AI アシスタント（Claude、ChatGPT、Cursor、その他あらゆる MCP クライアント）に、Tarotoo タロットカードの意味データセットへのリアルタイムアクセスを提供するモデルコンテキストプロトコルサーバーです。ライダー＝ウェイト＝スミス版の全 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 として登録されているため、レジストリに対応したクライアントから直接検出してインストールできます。

その後、「仕事におけるソードの 3 の意味は？」や「私のためにカードを 3 枚引いて」などとアシスタントに尋ねてください。以下のツールが呼び出されます。

ツール

ツール	引数	戻り値
get_card_meaning	name（文字列）	1 枚のカードの完全なレコード（意味、キーワード、恋愛／キャリア／気分／スピリチュアルの正位置と逆位置の解釈、惑星、星座、イエス／ノー）。カード名は柔軟に照合されます（"fool" → The Fool）
list_cards	arcana?（major/minor）、suit?（wands/cups/swords/pentacles）	カード名。任意で絞り込み可能
search_cards	query（文字列）、limit?（1～78、既定値 10）	テーマまたはキーワードに一致するカードを最も一致度の高い順に返します。例："heartbreak" → Three of Swords
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/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

データセットの 2 つの DOI は概念 DOI であり、常に最新バージョンを参照します。

解釈は、確立された資料（A. E. Waite 著『The Pictorial Key to the Tarot』（1911 年）、Golden Dawn の『Book T』に基づく対応付け）を参考に、Rider–Waite–Smith の伝統に沿って Tarotoo が作成しました。

ライセンス

コードとデータセット：MIT。Tarotoo（tarotoo.com）への帰属表示を歓迎します。

想定される用途

このデータセットは、教育、研究、創作、娯楽、自己省察を目的としています。医療、法律、金融、メンタルヘルス、その他の専門的な助言の代替として使用しないでください。