快速结论
Saju MCP Server 是一个面向韩国传统四柱命理的社区 MCP Server,可根据出生日期、时间、历法和性别生成排盘、运势、合婚、阴阳历转换、每日运势与大运等结果。它更适合做文化娱乐演示、MCP 开发样例或确定性规则计算参考,不应被视为科学测评,也不能替代医疗、法律、财务或人生决策建议。本站因此不将其列为推荐工具。
截至 2026-07-21,仓库清单声明 MIT,但仓库根目录没有可供核验的 LICENSE 文件;README 中展示 npm 与一键安装命令,但对应 npm 包当前不可作为可靠分发来源。稳妥路径是审查代码后从源码安装并固定提交。服务会把出生数据保存在进程内存缓存中:基础排盘缓存 TTL 为 60 分钟,大运与用神缓存为 120 分钟,并按小时清理;这仍是临时保留,且没有用户侧显式删除合同。HTTP 模式若按默认示例公开,未认证端点与宽泛 CORS 会放大隐私和滥用风险。
核心功能
- 四柱排盘与解释:根据出生信息计算天干地支,并提供性格、事业、财富、健康和感情等传统命理解读。
- 多种分析入口:整合基础分析、运势、用神、流派比较和用神方法等模式,减少 MCP 客户端需要选择的工具数量。
- 合婚参考:比较两组出生数据并生成兼容性结果,只适合作为娱乐内容,不能作为关系决策依据。
- 历法转换:使用项目内数据完成指定年份范围的阳历与阴历转换,并处理闰月输入。
- 周期结果:提供每日运势、十年大运及按年、月、时段或连续年份查询的结果。
- stdio 与 HTTP 形态:可作为本地 MCP 子进程运行,也包含 HTTP Server 入口;后者需要部署者自行补足鉴权、代理和网络边界。
- 确定性规则计算:核心排盘和表格查询主要由本地规则与数据完成,便于复现,但解释体系本身仍属于传统文化和娱乐范畴。
适合人群
- 想研究 MCP 工具定义、Zod 输入校验和 TypeScript Server 结构的开发者。
- 需要制作韩国四柱文化展示、娱乐机器人或教学原型,并会清楚标注非科学性质的创作者。
- 能审查依赖、固定 Git 提交、从源码构建并限制本地文件与网络权限的技术用户。
- 不适合希望获得专业健康、财务、婚恋或职业判断的人,也不适合直接接收公众出生数据的生产服务。
- 不适合缺少反向代理、身份认证、数据最小化和删除机制,却计划公开 HTTP 端点的团队。
使用场景
低风险场景是把它作为本地 MCP 示例:向测试客户端提供虚构出生数据,观察工具发现、参数校验和结构化结果。也可以在文化课程中比较不同传统解释规则,但输出必须标注“娱乐与参考”,并避免强化确定性预测。
若用于多人活动或公开网页,应先移除不必要字段、获得参与者同意、限制日志和缓存,并设置独立的认证网关。真实出生日期与时间具有识别和画像价值,不应复制到提示词历史、分析平台或第三方模型日志。虽然缓存会在 60 或 120 分钟后过期并按小时清理,部署者仍需提供显式删除或禁用缓存的办法,不能把 TTL 当作用户可控的删除机制。
价格与版本
仓库源码可免费获取,运行成本来自 Node.js 环境、部署、模型客户端和安全运维。项目清单中的 MIT 字段不能替代完整许可证文本;在仓库没有 LICENSE 文件的情况下,企业复用、再分发或商业部署应先向作者确认许可范围,并保留核验记录。
不要依据 README 假设 npm 包一定存在或持续可用。本文不提供 npm 一键命令,建议从仓库固定提交构建。第三方市场、托管模板或安装脚本也不是项目许可证、安全审计和可用性的保证。
国内访问与使用体验
源码构建后可本地运行,计算路径不依赖外部命理 API,延迟通常较低。仓库和依赖下载是否顺畅取决于当前网络与包源状态;这不等于需要配置任何网络代理服务。界面和术语以韩文及英文为主,中文用户需要理解阴阳历、时区、真太阳时修正和不同流派定义,不能只看自然语言结论。
安装前应逐行审查 install.sh,优先手动执行必要步骤,不要把远程脚本直接管道给 shell。HTTP 部署必须绑定内网地址或置于认证反向代理之后,收紧 CORS 来源,启用速率限制和日志脱敏,并把出生数据缓存视为需要删除策略的个人数据存储。
优点
- 七个整合工具覆盖排盘、合婚、历法和周期查询,演示 MCP 调用较直观。
- 核心规则与历法数据在本地执行,结果相对可复现,不依赖在线命理接口。
- TypeScript、MCP SDK 和输入 schema 组合适合阅读与二次实验。
- 同时提供 stdio 与 HTTP 代码,可用于比较本地子进程和远程传输的安全差异。
不足
- 命理解释没有科学验证,输出容易被误当成事实或决策依据。
- README 的 npm 分发说法与当前可用性不一致,自动安装说明可能失败或发生供应链漂移。
- 清单声明 MIT,但仓库缺少独立
LICENSE文件,复用与再分发前存在许可核验缺口。 - 出生数据会在进程内缓存 60 或 120 分钟并按小时清理,但缺少用户侧显式删除与完整审计合同。
- HTTP 模式缺少适合公网的默认鉴权边界,宽泛 CORS 会增加跨站调用和滥用面。
- 远程安装脚本会修改本机环境和客户端配置,执行前必须审查,不能视作安全的一键安装。
替代品对比
| 工具或方案 | 更适合的任务 | 主要差异 |
|---|---|---|
| 本地自写规则程序 | 可审计的历法转换或课堂演示 | 可以只保留必要计算,不携带命理解读和远程服务面 |
| Claude Code | 阅读仓库、审查安装脚本和改造 MCP 代码 | 它是开发客户端,不提供四柱规则数据 |
| Cursor | 在 IDE 中检查 TypeScript、依赖和 HTTP 安全配置 | 仍需人工判断许可证、隐私和部署边界 |
| Context7 | 为编码 Agent 查询技术文档 | 权限面更窄,不处理出生数据或娱乐预测 |
| n8n-MCP | 构建和验证 n8n 自动化工作流 | 面向工作流工程,不是命理计算工具,生产写入也需治理 |
常见问题 FAQ
Saju MCP Server 是科学预测工具吗?
不是。它把传统四柱规则编码为计算与文本解释,适合作为文化娱乐或软件演示。结果不能证明未来事件,也不应影响医疗、法律、财务、婚恋或就业决定。
可以直接用 npm 安装吗?
不应依赖这一假设。仓库文档展示过 npm 命令,但当前没有可确认的可靠 npm 包分发。应从源码固定提交构建,并核对锁文件、安装脚本和依赖来源。
仓库是 MIT 许可证吗?
package.json 等清单声明 MIT,但仓库没有独立 LICENSE 文件可核验完整条款。个人实验风险较低,商业使用、修改或再分发前仍应向作者确认并保存许可证明。
出生数据会被保存吗?
项目包含进程内记忆缓存:基础排盘数据 60 分钟,大运与用神数据 120 分钟,并有每小时清理任务。即使没有数据库,这仍是暂时保留;部署者应最小化输入、限制日志并实现用户可触发的显式删除或关闭缓存。
HTTP 模式可以直接公开到互联网吗?
不建议。应先增加身份认证、精确 CORS、TLS、速率限制、请求大小限制、审计和日志脱敏,并通过防火墙或反向代理限制来源。没有这些控制时只在本机或隔离网络测试。
可以执行 README 中的一键安装脚本吗?
不要直接执行 curl | bash。先下载到本地,核对脚本、目标路径、权限、依赖版本和对客户端配置的修改,再手动运行必要命令。远程脚本内容可能随分支变化。
总结
Saju MCP Server 的价值主要在于把韩国四柱规则包装成可调用的 MCP 工具,并展示本地确定性计算、stdio 和 HTTP Server 的实现方式。它的适用边界也很清楚:娱乐与参考,而非科学建议。当前 npm 分发不可依赖、许可证文件缺失、出生数据虽有 60/120 分钟 TTL 却缺少用户侧删除合同,加上未认证 HTTP/CORS 和安装脚本风险,使它不适合作为默认推荐的生产服务。