塔罗牌MCP服务器
  ](https://badge.fury.io/js/tarot-mcp)  ](https://nodejs.org)
一种模型上下文协议（MCP）服务器，为Claude、Cursor和其他MCP兼容工具等AI助手提供塔罗牌读取功能。
特性
- 完成78张塔罗牌 与主要和次要Arcana
- 多种排列布局 包括凯尔特十字架、过去、现在、未来等
- 卡片解读 具有正向和反向含义
- 智能读数 语境解释
- 搜索功能 按关键字查找卡片
- 每日抽卡 用于日常指导
安装
来自npm
npm install -g tarot-mcp来源
git clone https://github.com/yourusername/tarot-mcp.git
cd tarot-mcp
npm install
npm run build配置
克劳德桌面
将以下内容添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"tarot": {
"command": "npx",
"args": ["tarot-mcp"]
}
}
}如果从源代码本地安装：
{
"mcpServers": {
"tarot": {
"command": "node",
"args": ["/path/to/tarot-mcp/dist/index.js"]
}
}
}光标
添加到光标设置中：
- 打开光标设置(
Cmd+,在 macOS 上，Ctrl+,在Windows/Linux上） - 导航到“功能”选项卡
- 查找“模型上下文协议”或“MCP”部分
- 添加tarot服务器配置：
{
"mcpServers": {
"tarot": {
"command": "npx",
"args": ["tarot-mcp"]
}
}
}带连续扩展的VSCode
如果对VSCode使用Continue扩展：
- 打开继续设置(
~/.continue/config.json) - 将MCP服务器添加到
mcpServers章节：
{
"mcpServers": [
{
"name": "tarot",
"command": "npx",
"args": ["tarot-mcp"]
}
]
}其他MCP兼容工具
对于支持MCP服务器的任何工具，您通常需要：
- 命令:
npx tarot-mcp（如果从npm安装）或node /path/to/dist/index.js（如果是本地） - 运输：stdio（标准输入/输出）
- 服务器名称：塔罗牌
检查工具的文档以了解特定的配置格式。
可用工具
1. draw_cards
绘制指定数量的塔罗牌。
- 参数：
- count （数字）：要抽的牌数（1-78）
2. perform_reading
以特定的展开方式进行完整的皮重读数。
- 参数：
- spreadId （string）：要使用的点差ID - question （字符串，可选）：阅读问题
3. interpret_reading
获取塔罗牌读数的详细解释。
- 参数：
- reading （object）：读取对象来自 perform_reading
4. get_card_meaning
获取特定塔罗牌的详细信息。
- 参数：
- cardName （string）：卡片名称（例如“the Fool”、“Three of Cups”）
5. list_spreads
列出所有可用的塔罗牌撒布，并附上说明。
6. get_spread_info
获取特定点差的详细信息。
- 参数：
- spreadId （string）：点差ID
7. daily_card
画一张卡片作为日常指导。
8. search_cards
按关键字搜索塔罗牌。
- 参数：
- query （string）：搜索查询
9. list_all_cards
列出所有78张塔罗牌。
- 参数：
- arcana （字符串，可选）：按“主要”、“次要”或“全部”筛选
可用点差
single-card：单卡-快速洞察或日常指导past-present-future：过去、现在、未来——时间进程situation-action-outcome：形势、行动、结果——决策mind-body-spirit：心灵、身体、精神——全面的自我反思celtic-cross：凯尔特十字-全面的10张牌分析relationship-spread：关系传播-7卡关系动态career-spread：职业道路-五卡职业指导horseshoe：马蹄铁-7卡通用指南year-ahead：提前一年-每月12张卡decision-making：决策制定-五卡决策分析
示例用法
在克劳德桌面
配置后，您可以要求Claude使用塔罗牌工具：
"Draw three tarot cards for me"
"Perform a Celtic Cross reading about my career"
"What does The Fool card mean?"
"Show me all available tarot spreads"
"Do a past-present-future reading about my relationship"
"Search for cards related to 'love'"
"Give me a daily tarot card"在光标中
塔罗牌工具将可供AI助手使用。您可以在以下情况下使用它们：
- 聊天面板：要求AI进行阅读或解释卡片
- 内联代码生成：请求塔罗牌相关功能
- 终端命令：使用人工智能帮助解读读数
示例提示：
- “使用塔罗牌MCP服务器为今天抽一张牌”
- “执行关系传播阅读”
- “列出所有可用的塔罗牌点差”
在VSCode中，继续
配置后，使用以下命令：
- 类型
@tarot专门使用tarot服务器 - 提出诸如“绘制凯尔特十字架”之类的问题
- 请求解释：“三剑是什么意思？”
程序化使用
您还可以通过编程方式与MCP服务器交互：
// Example of calling the MCP server from your application
const reading = await mcp.call('tarot', 'perform_reading', {
spreadId: 'celtic-cross',
question: 'What should I focus on this month?'
});
const interpretation = await mcp.call('tarot', 'interpret_reading', {
reading: reading
});发展
建筑
npm run build本地测试
npm run dev项目结构
tarot-mcp/
├── src/
│ ├── index.ts # MCP server implementation
│ ├── types/ # TypeScript type definitions
│ │ └── tarot.ts
│ ├── data/ # Tarot card and spread data
│ │ ├── cards.ts
│ │ └── spreads.ts
│ └── tools/ # Tool implementations
│ └── tarot-tools.ts
├── package.json
├── tsconfig.json
└── README.md故障排除
常见问题
- 服务器未连接
- 确保服务器的路径正确 - 检查Node.js是否已安装且可访问 - 验证配置文件的JSON格式是否正确
- 命令不起作用
- 添加配置后重新启动AI工具 - 检查工具日志中的MCP连接错误 - 如果从源代码运行，请确保已构建项目
- “找不到工具”错误
- AI工具可能需要明确提示才能使用MCP服务器 - 尝试在请求前加上“使用塔罗牌MCP服务器…”
获取帮助
- 检查
- 验证您的配置是否与上述示例匹配
- 确保您使用的是最新版本
贡献
欢迎投稿！请随时提交拉取请求。
贡献的想法
- 添加更多塔罗牌涂抹
- 增强卡片解读
- 添加对不同塔罗牌传统的支持
- 实现卡片组合含义
- 添加日志功能
- 创建可视化工具
许可证
麻省理工学院
作者
阿卜杜勒·哈米德·阿奇克
致谢
- 塔罗牌的含义基于传统的Rider Waite Smith解释
- 与 模型上下文协议SDK
- 受几个世纪塔罗传统和现代数字占卜工具的启发
资源
-