Skip to main content
Glama
SihyeonJeon

legend-saju

by SihyeonJeon

Legend Saju

No es un envoltorio que pasa unos pocos caracteres de saju a un LLM. Es un motor de metafísica oriental que devuelve de forma estructurada los métodos de cálculo, las escuelas, las fuentes y la incertidumbre.

CI License TypeScript

El mismo nacimiento se calcula según varias tradiciones. En la ruta de cálculo no hay llamadas ocultas a un LLM.

Conocimiento con fuentes vinculadas, 777; Da Liu Ren, 720 configuraciones; hanja coreanos para nombres observados, 9.495; llamadas a modelos en la ruta de cálculo, 0

Legend Saju gestiona en un mismo motor los cálculos de tradiciones distintas: Saju y Myeongni, Zi Wei Dou Shu, Qimen Dunjia, Da Liu Ren, Cheolpan Sinsu, Seongmyeonghak y otras. Si las escuelas difieren, no las fuerza a converger en una única conclusión; si se desconoce la hora de nacimiento, no crea una hora arbitraria.

La forma más rápida de empezar

La versión pública actual ofrece a la vez MCP local por STDIO y MCP remoto por HTTPS. El servidor local se puede ejecutar sin necesidad de una clave de API distinta si hay Node.js 20 o superior.

Conectar a un servidor remoto sin instalar nada

El endpoint público de MCP es el siguiente.

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

desde Codex se puede conectar con el siguiente comando.

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

El servidor remoto no guarda los valores de entrada ni realiza llamadas a una API de modelos. El endpoint público está sujeto a límites de tamaño de petición, de peticiones por minuto y de ejecuciones simultáneas. Si no deseas enviar a un servidor externo la fecha de nacimiento o el nombre, usa el método local que se explica más abajo.

###Instalarlo como plugin

En Codex y en el ChatGPT CX de escritorio se puede instalar un plugin que combina la conexión MCP con las instrucciones de uso en ghiny language natural. Primero añade este repositorio como fuente del plugin.

codex plugin marketplace add SihyeonJeon/legend-saju --ref main

Después, desde la pantalla de Plugins instala Legend Saju. Este método usa el MCP remoto público, así que no necesitas Node.js ni una clave de API aparte. El registro en el directorio público de plugins de ChatGPT web es un paso posterior de envío y revisión.

Conectar con Codex desde una sola línea

Ejecuta el siguiente comando en la terminal.

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

Para confirmar la conexión:

codex mcp list

Tras volver a iniciar Codex, si ves legend-saju en /mcp, la instalación ha terminado. Ahora basta con escribir tus preguntas con normalidad, sin tener que mencionar el nombre de la herramienta ni el JSON.

Soy una mujer nacida el 30 de julio de 2000 a las 8:44 a.m.. Por favor, analiza de forma completa mi carrera, el dinero, el matrimonio y los próximos tres años.

Un hombre nacido el 14 de julio de 1999 a las 11:24 de la mañana, y una mujer nacida el 30 de julio de 2000 a las 8:44 de la mañana. Por favor, revisa a la vez la compatibilidad de la pareja y el momento en que podrían casarse.

Mi nombre es 김상수 (Kim Sang-su), con los caracteres 金相洹. Analiza, más allá del saju, también los fundamentos de la teoría del nombre en coreano.

El CLI de Codex, la extensión de Codex para IDE y la aplicación de escritorio ChatGPT comparten la misma configuración de MCP de Codex. Para más detalles sobre la conexión, consulta la guía de MCP de OpenAI.

Conexión desde otros clientes MCP

Si el cliente admite MCP por STDIO, se puede usar la siguiente configuración de ejecución. La ubicación exacta del archivo de configuración varía según el cliente.

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

Si prefieres fijar el código fuente local, primero compila el repositorio y ejecuta directamente el wrapper CLI.

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

El método local requiere ejecutar npm ci && npm run build una vez en la raíz del repositorio.

¿Se puede usar directamente desde un la web de ChatGPT?

El servidor remoto MCP por HTTPS está preparado. Aun así, el que exista una URL pública y el que esté registrado en el directorio de plugins de ChatGPT son pasos distintos. En la pasaje “desarrollo” o en clientes que admitan conexión MCP remota puedes usar directamente la URL anterior; para que el usuario normal lo vea como plugin instalable, queda un proceso de registro y revisión aparte.

Related MCP server: mcp-luopan

Lo que hace el MCP

El servidor MCP ofrece tres herramientas de solo lectura.

Herramienta

Función

legend_saju_manifest

Comprueba los métodos de cálculo, las fuentes y el alcance de los datos del motor actual

legend_saju_capabilities

Encuentra los métodos de cálculo adecuados a la pregunta en lenguaje natural

legend_saju_resolve

Recibe la pregunta y los datos de entrada y ejecuta juntos los métodos de cálculo pertinentes

Que haya tres herramientas no significa que haya tres funciones de la metafísica. Las herramientas son el pequeño punto de acceso en el que se revisa, se busca y se ejecuta un gran registro de funcionalidades.

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

El MCP de Legend Saju no lee las claves de API de OpenAI ni Anthropic, ni llama a un modelo. La conversación y las explicaciones usan la sesión de modelo ya existente del cliente que está en uso: Codex, Claude u otro.

Diferencia entre MCP y el plugin adjunto

  • Con solo conectar el MCP, puedes utilizar directamente el motor de cálculo y las tres herramientas.

  • El Plugin Codex de plugins/legend-saju/ incluye la configuración del MCP junto con instrucciones de uso en lenguaje natural. Así complementa el proceso de trabajo del modelo anfitrión, para que la persona no tenga que elegir un ID de capacidad ni un esquema de entrada.

  • La capacidad de cálculo no se distribuye copiada y adaptada dentro del plugin. Tanto el MCP como el plugin usan el mismo punto de entrada al motor público.

Entrada en lenguaje natural

La interfaz pretendida en este proyecto no es un formulario de inscripción o un menú de intenciones, sino la conversación. El modelo extrae de la conversación solo cierta información sólida, encuentra el método de cálculo necesario y explica los motivos que devuelve el motor.

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

Si se dice que la hora de nacimiento se desconoce, el motor no pone las 12 del mediodía de forma arbitraria. Devuelve a cartas separadas por candidatos, e incluye también las dos formas de tratar el cambio de día dentro de la hora Zi.

Ejecútalo como programador

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

Se necesite Node.js 20 o superior. Este repositorio es exclusivamente ESM y todavía no se publica en 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);

El valor de retorno no es una frase oraculada ya redactada, sino los datos de base para el cálculo y la interpretación.

{
  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;
}

Por qué he creado

Muchos servicios de IA astrológicos atribuyen un gran peso al promput. Legend Saju empieza desde una capa más abajo: cálculo y evidencias.

  • Núcleo determinista: los mismos datos de entrada producen el mismo resultado de cálculo, sin necesidad de un LLM.

  • Escuela preservada: cada la variante de lectura y acupuntura ideal o de las cuatro transformaciones del Zi Wei Dou Shu se guardan en su propio resultado.

  • Tratamiento de la hora de nacimiento desconocida: cuando se desconoce la hora se calcula como candidato, y no se inventa el mediodía.

  • Trazabilidad de las fuentes: cada función indica la dependencia de las fuentes, el nivel de madurez, el rol del criterio, la escuela, el ID de la fuente y las dimensiones que faltan.

  • No hay una puntuación del destitEssen: los fundamentos y los conflictos de sistemas distintos no se comprimen en combinación de un solo número.

Activos que se incluyen de verdad

Este repositorio no solo abre la interfaz de llamada a modelos; también publica el trabajo de datos y reglas difícil.

Activo

Selección

Repositorio de conocimiento clásico multilingüe

7369 áreas, 77 ítem con fuente

Glosario de terminología del saju =

777 entradas en coreano, chino, chino japonés

Glosario del Zi Wei Dou Shu.

2.214 entradas organizadas por idioma

Gungdongbogam

120 cajas de día × elar de la Luna y 66 cláusulas ejecutables de nivel inferior

Teoría de los Palacios y Estrellas del Zi Wei Dou Shu

163 reglas estructuradas y 3 marcos de transformación de los “Shir.hua” que se calculan de forma independiente

Da Liu Ren

tabla fija y cerrada de 60 días × 12 “cielos” y 719 configuraciones de transferencia

El "Tieban Shinsu" experiencia del tiempo de la pregunta

1.500 y hexagramas, 144 filas del cielo preostensible y 2.028 filas de la vida

Onomología corea

9.495 observaciones de hanja para nombre legal y 2.003 observaciones de variantes de trazo

Los 81 números con ámbito de las fuentes

81 filas completas con contador y recontra to con las fuentes primarias

Datos sobre el estudio de los sueños

988 sueños de Zhou el príncipe de... y el fragmento del sueño de Artemidoro y 5 semillas de control transcultural

Los datos verificables del escrito están en data/. The knowledge needed for execution is included in the runtime, so it does not depend on an external database or a hidden search service.

Las extracciones se fijan por archivo, y la única ruta de cálculo optimizada coincidió byte a byte con los resultados recogidos en las 144 vietos de Zi Wei Dou Shu. Los detalles se plantean en docs/PARITY.md.

Implementación de los límites

Sistema

Estado actual de implementación

El calendario y la base de saju

Conversión entre calendario solar, lunar y lunar, el "cuatro pilares", los períodos + de suerte y los límites del día

Myeong

mando del mes, la base de la escapada, las direcciónes ocultas, las diezechos, las combinaciones y choques atrás, 3 escuelas de la preselección del dios de función y los 120 espacios del Gongtong

El mikro

12 palacios, el esquema de la cuadrica y de las tres direcciones, múltiples marcos del “cuatro cambios”, las conexión de las “líneas de vuelo” y las capas de la copa de la suerte superpuestas

El Da Liu Ren

La tabla cerrada de los 60 sistemas por × 12 “mesas” del “cielo” y el método de las transformaciones con universo definido

El Qimen Dun Jia

los los del periodo temporal, el y los 9 palacios, las 9 extremidades, las 8 puertas, los 8 espíritus, los “duizhu” al y el vacío

El cheolpas

las cadenas del “Huang Ji” de las 3 ediciones, la tabla libre: 14 del tiempo de la pregunta, los números del cielo anterior y las 108 filas del árbol de vida

Onomología corea

El 9. generación, el desglose de letras y de Unicode, el cálculo de la diferencia de tipo (五格) en el sistema the user has told and the 81 -número de la tabla with its source

Es más preciso comprobar el elenco actual con getEngineManifest() que confiar en las cifras fijadas de este README.

La hora de nacimiento se interpreta como hora civil local. timezone y longitudeE se conservan como metadatos del lugar de nacimiento, pero la carta no estados aplica un ajuste de “huso horario” de forma implícita. Esta falta de ajuste queda registrada en el metadato de función y de auditoría de entrada.

Los datos de nacimiento que no son válidos se devuelven mediante la ruta estructurada blocked, para que puedas solicitar una corrección junto con el resto de resultados. If a targetDate or questionDateTime does not exist, the whole calculation based on dates cannot be done at all, so the request itself is refused.

Una sola puerta de entrada:

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

resolver({question, ...inputs}) busca en el registro actual, dirige la pregunta al método apropiado, ejecuta los soluciones con cálculo, y devuelve el resultado con los datos faltantes sin ocultarloplos. requestedCapabilities admite cadena de texto general, no un enum restringido. Por lo tanto, agregar un nuevo módulo al motor no obliga a actualizar de todos los esquemas de los clientes.

Si pasas el nombre a la entrada con name de resolveAsync, se abre un recorrido completo de onomología corea independiente. Realiza el apellido y el nombre propietario reales con el snapshot de observación de 9.495 hanungg and los resultados de legalidad posible, la ortografía asignada, los candidatos de trazo observados, la fuente (“Unicode”), la descomposición glifos, la fórmula de la 5 casillas del sistema del usuario y la tabla de 81 Letras, todo ello se guarda en capas distintas de fundamentación.

El símbolo presentado para resolve. Async loops not used, la carga diferida del gran data onométeo only if there is a nombre, así que no aumenta el coste de arranque de un cálculo de saju normal.

analyze(input) es una API de información de nacimiento con un tipo. query({intent, ...}) es la interfaz de la interfaz de compatibilidad de las 26 intenciones que utilizaban los bots. La automatización de la creación y la publicación de contenidos no se mezcla con el núcleo de cálculo.

Rendimiento

Se incluyen referencias comparables reproducibles.

npm run benchmark

En el hardware de desarrollo Apple Silicon actual y con Node 26, los valores de referencia optimizados fueron: en la consulta de la base del saju, la mediana de 1.13 ms; en una especificación total con hora de nacimiento conocida, mediana de alrededor de 600 ms; en la importación de un nuevo proceso, mediana de 63,1 ms. Estos valores técnicos pueden variar según el equipo y el variable. Los últimos valores y métodos de medida se dan en el PERFORMANCE.md.

Cuando no se conoce la hora

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

Las estructuras fijas, las relaciones variables y todos los xxxxxx de la hora que es devuelven por separado. Los acontecimientos pasados se pueden comparar con los candidatos, pero el motor nunca decide por sí pequeño la hora de nacimiento correcta.

Metodología por delante de los misterios

Este proyecto separa las siguientes etapas:

  1. Cálculo del calendario y del cruce de destino

  2. Observación del estructura

  3. Interpretación según la Escuela

  4. Síntesis de los diferentes sistemas

  5. Escritura hecha por un ser humano o un LLM

Antes de realizar afirmaciones de nivel product, hay que leer Metodología y Capacidades.

En Cómo se construye se incluye y desarrollo real, las consultas en diferentes idiomas y las instrucciones de trabajo reproducibles con el agente. La lista de distribución pública para los contribuidores está en docs/RELEASING.md.

Estado de la publicidad

El ámbito de distribución compatible es la fuente pública de GitHub. package.json está marcada como private para evitar su publicación en npm. npm run release:check comprueba que los archivos públicos coinciden con la instantánea del código fuente y que no hay ningún patrón de signo secreto común. Las fuentes de los datos y el alcance de la cita pública se documentan en DATA_LICENSES.md y en el archivodel.

Próximos pasos

  • Pantalla de entrada opcional para quien no usa clientes MCP

  • Estabilidad de la ejecución del MCP remoto y autenticación opcional

  • Pantalla separada de datos de naocts que funciona con datos privados por defecto

  • Paquete de datos de atención bajo licencia separada

  • Valores fijos de fuentes originales y revisión independiente por escuelas

Uso responsable

Legend Saju reproduce y comparan varios sistemas de astrología tradicional. Superar la validación de software significa reproducir los cálculos documentados; no significa que haya probado una capacidad predictiva científica. No se utilice en lugar de profesionales de salud, médicos, abogados, asesores financieros ni de salud mental.

Autoridad y forma de uso

El código del proyecto es Apache. Las bibliotecas externos de bibliotecas y los demás conjuntos de datos siguen sus propias condiciones de uso. Vea DATA_LICENSES.md y THIRD_PARTY_NOTICES.md.

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables Korean Saju (Four Pillars of Destiny) calculation and myeongni-hak glossary lookup via MCP, allowing AI clients to compute accurate saju analysis and look up fortune-telling terms.
    4
    44
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides tools for Bazi (Chinese astrology) chart calculation and analysis, enabling LLMs to generate accurate birth charts, determine patterns, and answer follow-up questions based on actual calculations rather than model knowledge.
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.
    8
    8
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Provides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.
    17
    28
    103
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • Chinese metaphysics (bazi, qimen, 5-element) as decision-support tools for AI agents.

  • Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

  • Deterministic reasoning stack for AI agents: simulate, decide & compute, plus cross-domain tools.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SihyeonJeon/legend-saju'

If you have feedback or need assistance with the MCP directory API, please join our Discord server