fatenava-mcp

fatenava-mcp

Español | 繁體中文 | 简体中文 | 日本語 | 한국어

Calcula cartas natales de BaZi, Zi Wei Dou Shu y astrología occidental desde cualquier agente de IA compatible con MCP.

Una herramienta, tres motores deterministas, cero configuración: sin cuenta, sin clave de API, sin almacenamiento. Impulsado por la API gratuita de cartas de FateNava.

Qué hace

Proporciónale un nacimiento (fecha, hora, lugar, género) y devuelve datos estructurados de la carta desde hasta tres sistemas:

Sistema	Lo que obtienes
BaZi 八字 (Cuatro Pilares del Destino)	Cuatro pilares (tallos y ramas), Maestro del Día, distribución de los Cinco Elementos — calculado con corrección de Hora Solar Verdadera según la longitud del lugar de nacimiento
Zi Wei Dou Shu 紫微斗數 (Astrología de la Estrella Púrpura)	Doce palacios con estrellas principales, Palacio de la Vida, transformaciones
Carta natal occidental	Zodiaco tropical, casas de Placidus: Ascendente, planetas por signo/casa, elementos y modalidades

Los números están calculados, no generados por IA — el mismo nacimiento siempre produce las mismas cartas. La interpretación queda a cargo de tu agente de IA (o de las herramientas gratuitas de lectura de FateNava).

Inicio rápido

Claude Code

claude mcp add fatenava -- npx -y fatenava-mcp

Codex CLI

# ~/.codex/config.toml
[mcp_servers.fatenava]
command = "npx"
args = ["-y", "fatenava-mcp"]

Cursor / cliente MCP genérico

{
  "mcpServers": {
    "fatenava": {
      "command": "npx",
      "args": ["-y", "fatenava-mcp"]
    }
  }
}

Herramientas

• cast_chart — Calcula cartas natales de BaZi (Cuatro Pilares), Zi Wei Dou Shu y astrología occidental a partir de un solo dato de nacimiento. Cálculo determinista con corrección de Hora Solar Verdadera; admite texto de nacimiento multilingüe en una línea o campos estructurados.

cast_chart

Dos formas de describir el nacimiento — elige una:

1. Texto en una línea (lo más fácil; la API analiza fecha, hora, lugar y género, y resuelve la ciudad a coordenadas + zona horaria):

{ "text": "1995-08-10 12:00 Taipei female" }

Se aceptan nombres de ciudades en inglés, chino, japonés o coreano.

2. Campos estructurados:

{
  "year": 1995, "month": 8, "day": 10, "hour": 12, "minute": 0,
  "gender": "female",
  "longitude": 121.5, "latitude": 25.04, "timeZoneId": "Asia/Taipei"
}

Opcional:

• systems: ["bazi", "ziwei", "astro"] — elige un subconjunto para mantener la respuesta pequeña (por defecto: los tres).
• birthTimeKnown: false — cuando se desconoce la hora exacta. BaZi aún devuelve tres pilares; las partes dependientes de la hora se omiten honestamente en lugar de adivinarse.

Forma de la respuesta

{
  "birth": { "date": "1995-08-10", "time": "12:00", "gender": "female", "place": "…" },
  "timeKnown": true,
  "charts": {
    "bazi":  { "ok": true, "view": { "dayMaster": {…}, "fourPillars": […], … } },
    "ziwei": { "ok": true, "view": { "palaces": […], … } },
    "astro": { "ok": true, "view": { "ascendant": {…}, "bodies": […], … } }
  }
}

Los nombres de los campos están en inglés; los términos tradicionales (tallos celestiales, ramas terrenales, nombres de palacios y estrellas) aparecen en sus caracteres chinos nativos — pide a tu agente que los traduzca para el usuario.

Notas y principios

• Gratuito y anónimo. El endpoint subyacente no requiere inicio de sesión y no almacena nada.
• Determinista. Las cartas se calculan con motores probados; la capa de IA solo interpreta.
• Honesto sobre los límites. La hora de nacimiento desconocida se degrada con elegancia en lugar de inventar una hora. Las cartas describen tendencias y temas — no un destino fijo. No son consejo médico, legal ni financiero.
• Aprende los conceptos: ¿Qué es BaZi? · ¿Qué es una carta natal? · ¿Qué es Zi Wei Dou Shu?
• Lecturas completas, compatibilidad (sinastría / 合婚) y preguntas y respuestas con IA: fatenava.com

Desarrollo

npm install
npm run build
node dist/index.js   # speaks MCP over stdio

La variable de entorno FATENAVA_API_BASE anula el origen de la API (para pruebas).

Licencia

MIT