内容
# Tarotoo 塔罗牌 MCP 服务器
[](https://www.npmjs.com/package/tarotoo-mcp-server)
[](https://github.com/Tarotoo-com/tarotoo-mcp-server/actions)
[](https://registry.modelcontextprotocol.io/v0/servers?search=tarotoo)
[](package.json)
[](LICENSE)
[](https://doi.org/10.5281/zenodo.21298383)
一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，为 AI 助手（如 Claude、ChatGPT、Cursor 等 MCP 客户端）提供实时的 [Tarotoo 塔罗牌含义数据集](https://github.com/Tarotoo-com/tarotoo-tarot-dataset) 访问权限：所有 **78 张牌**，遵循 Rider–Waite–Smith 传统，包括正反面含义、关键词、正反面爱情、事业、情绪、精神层面的关联、行星和星座关联，以及正反面是/否值。
由 [Tarotoo](https://tarotoo.com/open-data) 发布：这些是 Tarotoo.com 上 AI 读取的相同牌含义。
## 快速开始
需要 Node.js ≥ 18。不需要安装，客户端可以通过 `npx` 运行。
**Claude 代码**
```bash
claude mcp add tarotoo-tarot -- npx -y tarotoo-mcp-server
```
**Claude 桌面版** - 添加到 `claude_desktop_config.json`（设置 → 开发者 → 编辑配置）：
```json
{
"mcpServers": {
"tarotoo-tarot": {
"command": "npx",
"args": ["-y", "tarotoo-mcp-server"]
}
}
}
```
**Cursor / Windsurf / 其他 MCP 客户端** - 在客户端的 MCP 设置中使用相同的 `command`/`args` 对。
**MCP 注册中心** - 在 [io.github.Tarotoo-com/tarotoo-mcp-server](https://registry.modelcontextprotocol.io/v0/servers?search=tarotoo) 下列出，因此支持注册中心的客户端可以直接发现并安装它。
然后询问您的助手类似 *"三张剑牌对我的事业意味着什么？"* 或 *"为我抽三张牌"* - 它将调用以下工具。
## 工具
| 工具 | 参数 | 返回值 |
|---|---|---|
| `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"}
```
```json
{
"name": "星星",
"arcana": "major",
"element": "空气",
"planet": "土星",
"zodiac": "水瓶座",
"yes_no": "yes",
"yes_no_reversed": "no",
"keywords_upright": ["希望", "更新", "治愈", "灵感", "信仰"],
"meaning_upright": "希望，更新，治愈，灵感，信仰。",
"love": "爱情中的希望，情感治愈，信任的更新，令人鼓舞的联系",
"love_reversed": "失去信仰，沮丧，脱节，希望的黯淡"
}
```
每张牌都包含关键词、含义、爱情、事业、情绪、精神和是/否的正反面值。上面的示例是简化的。
## 从源码运行
```bash
git clone https://github.com/Tarotoo-com/tarotoo-mcp-server.git
cd tarotoo-mcp-server
npm install
npm test # 8-check 烟雾测试：完整的 MCP 会话，通过 stdio
node server.js # stdio 传输
```
## 数据集
嵌入的 `data/cards.json` 是从 [tarotoo-tarot-dataset](https://github.com/Tarotoo-com/tarotoo-tarot-dataset)（[MIT](https://github.com/Tarotoo-com/tarotoo-tarot-dataset/blob/main/LICENSE)）构建的，也可在 [Hugging Face](https://huggingface.co/datasets/Tarotoo/tarotoo-tarot-card-meanings)、[Kaggle](https://www.kaggle.com/datasets/tarotoo/tarotoo-tarot-card-meanings)、[npm](https://www.npmjs.com/package/tarotoo-tarot)和 [PyPI](https://pypi.org/project/tarotoo-tarot/) 上获得，具有可引用的 DOI： [10.5281/zenodo.21285777](https://doi.org/10.5281/zenodo.21285777)（数据集 + 数据集论文；概念 DOI，始终是最新的）和 [10.5281/zenodo.21268290](https://doi.org/10.5281/zenodo.21268290)（完整的存储库/存档：数据集、源文件、构建脚本、自动化验证、软件包、文档；概念 DOI，始终是最新的）。
塔罗牌解释由 Tarotoo 在 Rider–Waite–Smith 传统中创建，借鉴了已有的资料（A. E. Waite 的 *The Pictorial Key to the Tarot*，1911 年；依照黄金黎明的 *Book T* 的归属）。
## 许可证
代码和数据集：[MIT](LICENSE)。鼓励引用 Tarotoo（tarotoo.com）。
## 用途
此数据集旨在用于教育、研究、创意、娱乐和自我反思目的。它不应作为医疗、法律、财务、心理健康或其他专业建议的替代品。
