关于 cafe-mcp
cafe-mcp 为 AI Agent 和 MCP 客户端提供四柱与八字计算。其 CAFE 引擎返回可复现的命盘和历法数据,由客户端的 AI 负责解读。
主要功能
- 01确定性四柱命盘计算
- 02按年和月查询运势周期
- 03公历与农历日历
- 04可搜索的命理典籍
- 05出生地与日期查询
适用场景
- 01根据出生信息生成命盘
- 02结合命盘查看运势周期
- 03查找符合指定柱的日期
MCP 相关
它向 MCP 客户端提供四柱与八字计算、历法查询、术语检索和典籍搜索工具。客户端可通过登录或 bearer token 连接其托管端点。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.24plus.ai.kr/mcpclaude mcp add --transport http dangamsoft-cafe https://mcp.24plus.ai.kr/mcp{"mcpServers":{"dangamsoft-cafe":{"type":"http","url":"https://mcp.24plus.ai.kr/mcp"}}}在 Cursor 中打开{"servers":{"dangamsoft-cafe":{"type":"http","url":"https://mcp.24plus.ai.kr/mcp"}}}在 VS Code 中打开{"mcpServers":{"dangamsoft-cafe":{"type":"http","url":"https://mcp.24plus.ai.kr/mcp"}}}{"mcpServers":{"dangamsoft-cafe":{"serverUrl":"https://mcp.24plus.ai.kr/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
6| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| loc | integer | 否 | 韩国境外出生时使用的 24Plus 世界城市 ID。 |
| sex | enum | 否 | 出生时的性别;用于确定 10 年大运的方向。除非提供旧版 'gender',否则必填。female | male |
| name | string | 否 | 可选的显示名称。 |
| birth | string | 是 | 当地出生日期和时间。采用 ISO 8601 格式 'YYYY-MM-DDTHH:mm'(例如 1990-01-15T10:30),或旧版 12 位格式 'YYYYMMDDHHmm'。如果时间未知,请使用 12:30 并设置 time_unknown。 |
| gender | any | 否 | 性别的旧版形式:0 表示女性,1 表示男性。 |
| option1 | any | 否 | rat_hour_rule 的旧版形式(1 = early)。 |
| option2 | any | 否 | year_boundary 的旧版形式(-1 = winter_solstice)。 |
| calendar | enum | 否 | 出生日期所用的历法。默认为阳历。solar | lunar |
| is_lunar | boolean | 否 | calendar=lunar 的旧版形式。 |
| timezone | string | 否 | 出生地的 IANA 时区。Asia/Seoul 可直接使用;其他地区出生请传入 'loc'。 |
| is_leap_year | boolean | 否 | lunar_leap_month 的旧版形式。 |
| time_unknown | boolean | 否 | 出生时间未知;时柱将标记为估算值。 |
| rat_hour_rule | enum | 否 | 子时规则:'late' 야자시(默认)或 'early' 조자시。late | early |
| year_boundary | enum | 否 | 年柱边界:'lichun' 입춘(默认)或 'winter_solstice' 동지。lichun | winter_solstice |
| lunar_leap_month | boolean | 否 | 农历闰月(윤달)。仅适用于 calendar=lunar。 |
详细介绍
cafe-mcp:Saju 与 BaZi(四柱命理)MCP 服务
为 AI Agent 提供韩国占星术(Saju,사주)和中国八字。基于计算,而非猜测。 向 Claude、ChatGPT、Cursor 或任何 MCP 客户端提供出生日期和时间。cafe-mcp 会通过 CAFE 引擎返回四柱命盘、 大运流年、万세력(만세력)日历和经典文献,作为结构化、可复现的数据。你的 AI 会用用户的语言撰写解读。
为什么不直接问大模型? 通用模型会临场编造命盘:相同的出生数据,日主可能每天都不一样;节气交界、藏干和大运也经常算错。 cafe-mcp 使用自 2019 年起构建的引擎进行计算:精确到秒的节气、出生地经度、历史时区和夏令时。同样的输入,每次得到相同的命盘。
快速开始
服务 URL:
https://mcp.24plus.ai.kr/mcp
claude.ai、Claude 应用、ChatGPT:使用上面的 URL 添加自定义连接器,登录 24PLUS,然后授权。 无需密钥。
Claude Code、Cursor 和其他客户端:可以添加 URL 并登录(OAuth),也可以在 https://24plus.ai.kr/my 创建密钥,并将其作为 bearer token 发送:
claude mcp add --transport http cafe-mcp https://mcp.24plus.ai.kr/mcp --header "Authorization: Bearer mcp_live_..."
{ "mcpServers": { "cafe-mcp": { "url": "https://mcp.24plus.ai.kr/mcp", "headers": { "Authorization": "Bearer mcp_live_..." } } } }
随时可以在 我的账户 > 已连接的 AI 中断开连接。
套餐
| 免费版 | Plus(即将推出) | |
|---|---|---|
| 每月不同命盘数 | 10 | 100 |
| 每月工具调用次数 | 300 | 3,000 |
| 每分钟调用次数 | 20 | 60 |
| 引擎判断(格局、用神、运势指数) | – | ✓ |
| 经典文献 | 3 条结果、翻译摘录、目录 | 10 条结果、完整翻译、完整章节 |
已查询过的命盘不会重复计数。详情:https://24plus.ai.kr/pricing
工具
| 工具 | 套餐 | 功能 |
|---|---|---|
saju_chart | 免费版 | 四柱,包含汉字、五行、十神、藏干、十二长生、神煞、合、冲和空亡 |
luck_cycles | 免费版 | 十年大运,包含起运年龄、流年和流月 |
saju_reading_context | 免费版 | 将命盘事实、当前运势、术语释义和解读原则整合为适合提示词使用的信息包。解读时最适合作为首次调用 |
manse_calendar | 免费版 | 一个月的阳历和阴历日期、日柱、精确节气时间、吉日 |
find_dates_by_pillars | 免费版 | 反向查询:能够生成指定四柱的日期和时间 |
find_birthplace | 免费版 | 按城市搜索,以进行经度校正(韩国境外出生者) |
lookup_term | 免费版 | 980 个 Saju 术语,提供韩语、汉字和英语 |
search_classics | 免费版 | 《子平真诠》《滴天髓》《穷通宝鉴》等,包含原文和韩语翻译 |
read_classic | 免费版 | 文库和各书目录(Plus 可查看完整章节) |
chart_structure | Plus | 日主强弱(1 至 5 级)及其依据、五行比例、格局、调候 |
useful_element | Plus | 通过五种经典方法得出的用神候选,以及引擎选出的用神 |
luck_index | Plus | 为每个大运、年份或月份给出 1 至 5 级评估,并说明理由 |
包含输入参数和示例提示词的完整参考文档:https://24plus.ai.kr/docs/tools
返回值为韩语并附有汉字;传入 lang="en" 可获取英语术语名称。
原则
- 计算结果具有确定性;解读由你的 AI 根据返回的数据完成。
- 免费工具不提供评分或固定预测。等级用于描述趋势的强弱。
- 出生数据仅用于计算。服务端会保存用于统计每月命盘数量的单向指纹,绝不保存出生日期本身。参见 PRIVACY.md。
v1.1.0 之前
截至 2026-10-18,此 URL 提供的是开放服务,包含 6 个工具且无需登录;npm 包
@dangamsoft/cafe-mcp 则通过 stdio 在本地运行该服务。两者均已停止使用;npm 包已弃用。
请参阅 CHANGELOG.md。
关于
cafe-mcp 由韩国的 24PLUS(Dangamsoft)运营,基于 CAFE 引擎构建。 网站:https://24plus.ai.kr · Business API(Core API):https://24plus.ai.kr/mcp#business
许可:本仓库中的代码采用 Apache-2.0 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。