Sully Tarot MCP

一个专门给 SullyOS 角色使用的无状态塔罗 MCP。角色真实调用工具抽牌，看到正逆位和关键词后，用自己的口吻解读，并在聊天里展示现成的 HTML 塔罗卡片。

特点

• 完整 78 张韦特体系牌组
• 单张、过去/现在/未来、关系牌阵
• 可选正逆位，单次抽牌不重复
• 使用 Web Crypto 随机抽取，不保存问题或结果
• Streamable HTTP MCP，兼容 SullyOS 通用 MCP 客户端
• 自带 SullyOS [html]...[/html] 卡片内容
• 单个 Cloudflare Worker，无数据库、无 API Key、无定时任务

塔罗用于娱乐和自我探索，不应替代医疗、法律、财务等专业判断。

部署到 Cloudflare Workers

npm run deploy

首次运行会由 Wrangler 引导登录 Cloudflare。部署成功后，MCP 地址通常是：

https://sully-tarot-mcp.<你的子域>.workers.dev/mcp

Worker 对任意路径都提供相同 MCP 服务，因此根地址也可以使用；推荐保留 /mcp 便于辨认。

接入 SullyOS

1. SullyOS → 设置 → MCP 工具服务器 → 配置。
2. 新增服务器，名称填写 塔罗。
3. URL 填入上面的 Worker /mcp 地址，不需要 Token 和代理。
4. 点击“测试连接”，应发现一个工具 draw_tarot。
5. 启用服务器，并按需绑定到某个角色。

之后可以在聊天中说：

• “替我抽一张今天的牌。”
• “用三张牌看看这件事的过去、现在和未来。”
• “给我们抽一个关系牌阵。”

工具描述会要求角色先用自己的口吻解读，再把返回的 sullyos_html 放进 [html]...[/html] 中。HTML 卡片无脚本，符合 SullyOS 的沙盒限制。

本地验证

npm test
npm run dev

本项目没有运行时依赖。npm run dev 和 npm run deploy 会按需调用 Wrangler。

MCP 工具

draw_tarot

参数：

字段	类型	说明
spread	single | three_card | relationship	默认 single
question	string	可选，最多 500 字符
allow_reversed	boolean	是否允许逆位，默认 true

服务完全无状态：每次调用独立抽牌，不写入数据库、Cookie 或日志存储。