Legend Saju

不是把四柱几个字丢给 LLM 的包装器。 是将计算式、流派、出处、不确定性结构化后返回的东方命理引擎。

同样的出生年月日，用多种传统各自推算。计算路径内不存在隐藏的 LLM 调用。

可追溯出处的知识 777 条 · 大六壬 720 局 · 韩国人名用汉字观测 9,495 条 · 计算路径模型调用 0 次

Legend Saju 在同一个引擎中处理四柱·命理、紫微斗数、奇门遁甲、大六壬、铁板神数、姓名学等不同传统的计算。流派不同就不强行统一为单一结论，出生时间不明也不会臆造一个时辰。

最快上手

当前公版同时提供本地 STDIO MCP 与 HTTPS 远程 MCP。本地服务器只要装有 Node.js 20 或更高版本，无需另配 API 密钥即可运行。

无需安装，直连远程服务器

公开 MCP 端点地址如下。

https://legend-saju-mcp-production.up.railway.app/mcp

在 Codex 中可用以下命令连接。

codex mcp add legend-saju-remote --url https://legend-saju-mcp-production.up.railway.app/mcp

远程服务器不保存输入值，也不调用模型 API。公开端点设有请求大小、每分钟请求数、并发执行数等限制。如果不想将出生日期或姓名发给外部服务器，请改用下面的本地方案。

Codex 一行连上

在终端中运行以下命令。

codex mcp add legend-saju -- npx -y --package=github:SihyeonJeon/legend-saju#main legend-saju-mcp

检查是否连接成功。

codex mcp list

重启 Codex 后，在 /mcp 中看到 legend-saju，即表示安装完成。现在无需提任何工具名或 JSON，可以像平常一样直接提问了。

女生，2000 年 7 月 30 日上午 8 点 44 分出生。请综合看事业、财运、婚姻和未来三年。

男生 1999 年 7 月 14 日上午 11 点 24 分出生，女生 2000 年 7 月 30 日上午 8 点 44 分出生。请一起看配对和可能结婚的时间。

名字是 김상수，汉字名是 金相洙。请与四柱分开，单看姓名学依据。

Codex CLI、Codex IDE 扩展、ChatGPT 桌面应用共用同一份 Codex MCP 配置。更详细的连接说明请见 OpenAI 的 MCP 指南。

从其他 MCP 客户端连接

只要客户端支持 STDIO MCP，就可以使用下面的运行配置。不同客户端的配置位置略有差异。

{
  "mcpServers": {
    "legend-saju": {
      "command": "npx",
      "args": ["-y", "--package=github:SihyeonJeon/legend-saju#main", "legend-saju-mcp"]
    }
  }
}

如果希望固定使用本地源码，可先 build 本项目，再直接运行 CLI 包装器。

{
  "mcpServers": {
    "legend-saju": {
      "command": "node",
      "args": ["/절대/경로/legend-saju/bin/legend-saju-mcp.js"]
    }
  }
}

本地方式需在谱系仓库根目录运行一次 npm ci && npm run build。

可以在 ChatGPT 网页直接用吗

HTTPS 远程 MCP 服务器已经就绪，但“拥有了公网 URL”和“进入 ChatGPT 插件目录”是两个阶段。开发者模式或支持远程 MCP 的客户端可以直接使用上面的 URL；要作为可安装普通插件面向大众，还需要单独的注册审查流程。

Related MCP server: mcp-luopan

MCP 做什么

MCP 服务器提供三个只读工具。

只有三个工具，并不意味着功能也只有三项。这三个工具只是通往一个更大功能注册表的查、找、跑三扇小门。

사용자의 자연어 질문
        ↓
호스트 모델이 입력을 정리하고 계산법을 탐색
        ↓
Legend Saju MCP가 결정론적 계산 수행
        ↓
출처·유파·충돌·누락 정보가 포함된 구조화 결과
        ↓
호스트 모델이 사람이 읽기 쉬운 한국어로 설명

Legend Saju MCP 本身不读取 OpenAI 或 Anthropic 的 API 密钥，也不调用模型。对话和解释用的都是当前 Codex、Claude 或其他客户端已有的模型会话。

MCP 与附带的谱系插件的区别

• 只用 MCP，即可立即使用计算引擎和三个工具。

• 在 plugins/legend-saju/ 中附带的 Codex 插件会把 MCP 配置和自然语言使用方法放到同一套配置里，避免用户自己去选，的宿主模型也不用再自己挑能力 ID 或输入结构。

• 计算能力不会在插件里缩水，MCP 和插件都用同一套公开的引擎入口。

自然语言输入

项目设计的交互方式就是对话，而不是填写表单或从意图菜单里挑选项。模型只从对话中提取确定信息，找到需要的计算法，再去解释引擎返回的依据。

2004년 8월 3일 양력 남자고 태어난 시간은 몰라.
경기도 구리에서 태어났어. 앞으로 3년 직업과 돈을 봐줘.

如果用户说不知道出生时间，引擎不会随手填入午时（中午 12 点）。而是把子时双旦的两种界界、两个日期和候选方式放置在两条候选路径，完整分开返回。

开发者运行

git clone https://github.com/SihyeonJeon/legend-saju.git
cd legend-saju
npm ci
npm test
npm run build
npm run demo

需要 Node.js 20 或更高版本。这个存储库只支持 ESM，当前未发布到 npm。

import { resolve } from "./dist/index.js";

const result = resolve({
  birth: {
    year: 2000,
    month: 7,
    day: 30,
    hour: 8,
    minute: 44,
    calendar: "solar",
    gender: "여",
    birthTimeAccuracy: "recorded"
  },
  question: "직업과 재물, 연애 결혼, 앞으로 3년",
  timelineRange: { startYear: 2026, endYear: 2028 }
});

console.log(result.dossier?.claims);
console.log(result.dossier?.conflicts);
console.log(result.routes);

返回的不是形成整段“断语”的句子，而是计算与解读的“史料”。

{
  selection: { requested: string[]; selected: string[]; unsupported: string[] };
  routes: CapabilityPreflight[];
  dossier?: {
    claims: EngineClaim[];
    conflicts: ClaimConflict[];
    synthesis: DomainSynthesis[];
    timeline?: LifeTimeline;
    blockedSystems: { capabilityId: string; reason: string }[];
  };
  evidence: SajuEvidence[];
  nameAnalysis?: KoreanNameAnalysis;
  noModelCalls: true;
  interpretationBoundary: string;
}

为什么做这个

不少命理 AI 服务是从 prompt 起家的，Legend Saju 选择再往下一层，从计算和依据出发。

• 确定性预设: 同样输入，即便没有 LLM 也能生成同样的结果。

• 保存流派差别: 命理观察方式或紫微斗数四化派系不同时，各自保留结论。

• 出生时间未知: 物理时间未知时把它作为候选点处理，而不是顺手假装成午时。

• 出处可追踪: 每一项功能都记录成熟度、发挥的作用、所属流派、出处 ID，以及哪方面还缺失。

• 没有“命运评分”: 不会把星体系中多种冲突和依据压成一个总分。

实际含有的的资料资产

这个存储库并不只发布了模型调用接口，还公开了难处理的数据和规则工程。

可核查的原始资料都放在 data/ 里。运行必需的知识已打进运行时，不会临时依赖外部数据库或隐藏的检索服务。

提取结果按文件预置，唯一做过加速的路径是紫微斗数 144 个组合，检定后与现有结果逐字节一致，详见 docs/PARITY.md。

实现范围

比起照抄 README 给出的静态功能数量，用 getEngineManifest 查看当前注册表更准确。

出生时辰按（当地民用计时）解释。timezone 与 longitudeE 保留为出生地元数据，但默认盘不会悄悄修正为近似真太阳时。这种缺失会写入功能与输入审计元数据。

错误出生信息会以结构化 blocked 路径返回，并与其他结果一起请求修正。不可能存在的 targetDate 或 questionDateTime 会导致所有日期相关计算都无法安全进行，因此会直接拒绝整个请求。

一个开放的入口

import { resolve } from "./dist/index.js";

resolve({ question, ...inputs }) 会搜索当前注册表、路由提问、调用可运行的计算器，并返还给用户，不会把缺失输入偷偷隐藏。requestedCapabilities 接受的不是封闭枚举，而是一组普通字符串。因此，即使后续在引擎中加入新模块，也无需所有客户端同步改 schema。

resolve 继续可用，与原有计算式用户兼容；异步版只有在传了名字时，才会懒加载大型姓名数据。因此一般四柱算或消费解析的场景，启动成本不会增加。

如果传入 name 给 resolveAsync，就能进入独立的韩国姓名学完整流程：把真实姓氏和名字汉字与 9,495 条观测快照对照，并记录合法性结论、官方读音、笔画候选、Unicode、字形拆解、用户指定的五格机制，以及 81 数表的对应层级。

resolve 保留同步模式专门供纯算的用户使用，只处理问八字类逻辑。analyze({ ...birth }) 是类型的出生说明 API；query({ intent, ... }) 则是旧系统的容器习惯的 26 个 intent 兼容接口。内容创建、提示词、写作自动化都不放入计算核心。

性能

仓库自带有可复现的 benchmark。

npm run benchmark

当前 Apple Silicon 开发机和 Node 26 下，优化基准分别为：四柱原局查询中位数约 1.13ms，常规完整出生原始中位数约 600ms，全新进程 import 中位数约 63.1ms。具体中位数随时间而不同，测量方法参见 PERFORMANCE.md。

出生时间未知时

const result = analyze({
  birth: {
    year: 2004,
    month: 8,
    day: 3,
    calendar: "solar",
    gender: "남",
    birthTimeAccuracy: "unknown"
  },
  question: "전체 인생"
});

引擎会把固定柱、不同关系、不同时柱候选分别返回。即使用衣过去的事件来往之间，也不会由它一锤的.

方法论优先

项目把下面的步骤严格分开：

1. 历法推算与原局计算

2. 局部结构观察

3. 按流派解读结果

4. 跨体系综合推断

5. 由人或 LLM 写描述

做回真正产品级论点之前，建议先读 方法论 与 能力边界。

实际开发过程 里记录了开发顺序、多语种调查、可复现智能体指令；给维护用的 GitHub 发布清单在 docs/RELEASING.md。

发布状态

分发形态就是可公开的 GitHub 源码。package.json 标为 private，避免误发到 npm。npm run release:check 会检查发布文件与源码快照是否一致，是否有常见的密钥字符串。数据的出处与发布范围已写入数据标注文件 DATA_LICENSES.md 中。

下一步

• 为不使用 MCP 的人提供可选输入界面

• 远程 MCP 稳定运行和可选认证

• 默认非公开的独立出生时间录入页面

• 单独授权的解梦数据包

• 增加附加刻度与各流派独立核验

负责任的使用

Legend Saju 是对传统命理体系本体的复现与比较。通过软件验证意味着其能够，按文档化步骤计算结果，不意味着它拥有被验证了的实际预测能力。它不应该被用于代替医学、法律、财务或心理医生的判断。

许可

项目代码采用 Apache-2.0。第三方库与数据延用其各自的许可。详情见 DATA_LICENSES.md 与 THIRD_PARTY_NOTICES.md。