fatenava-mcp

fatenava-mcp

Português | 繁體中文 | 简体中文 | 日本語 | 한국어

Calcule mapas natais de BaZi, Zi Wei Dou Shu e astrologia ocidental a partir de qualquer agente de IA compatível com MCP.

Uma ferramenta, três mecanismos determinísticos, zero configuração: sem conta, sem chave de API, nada armazenado. Alimentado pela API gratuita de mapas do FateNava.

O que faz

Forneça um nascimento (data, hora, local, sexo) e ele retorna dados estruturados do mapa de até três sistemas:

Sistema	O que você obtém
BaZi 八字 (Quatro Pilares do Destino)	Quatro pilares (troncos e ramos), Mestre do Dia, distribuição dos Cinco Elementos — calculados com correção de Tempo Solar Verdadeiro a partir da longitude do local de nascimento
Zi Wei Dou Shu 紫微斗數 (Astrologia da Estrela Púrpura)	Doze palácios com estrelas principais, Palácio da Vida, transformações
Mapa natal ocidental	Zodíaco tropical, casas de Placidus: Ascendente, planetas por signo/casa, elementos e modalidades

Os números são calculados, não gerados por IA — o mesmo nascimento sempre produz os mesmos mapas. A interpretação fica a cargo do seu agente de IA (ou das ferramentas gratuitas de leitura do FateNava).

Início 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"]
    }
  }
}

Ferramentas

• cast_chart — Calcula BaZi (Quatro Pilares), Zi Wei Dou Shu e mapas natais ocidentais a partir de um único nascimento. Cálculo determinístico com correção de Tempo Solar Verdadeiro; aceita texto de nascimento multilíngue em uma linha ou campos estruturados.

cast_chart

Duas maneiras de descrever o nascimento — escolha uma:

1. Texto em uma linha (mais fácil; a API interpreta data, hora, local e sexo, e resolve a cidade para coordenadas + fuso horário):

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

Nomes de cidades em inglês, chinês, japonês ou coreano são aceitos.

2. Campos estruturados:

{
  "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"] — escolha um subconjunto para manter a resposta pequena (padrão: todos os três).
• birthTimeKnown: false — quando a hora exata é desconhecida. O BaZi ainda retorna três pilares; as partes dependentes da hora são omitidas honestamente, em vez de serem adivinhadas.

Formato da resposta

{
  "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": […], … } }
  }
}

Os nomes dos campos estão em inglês; os termos tradicionais (troncos celestes, ramos terrestres, nomes de palácios e estrelas) vêm em seus caracteres chineses nativos — peça ao seu agente para traduzi-los para o usuário.

Notas e princípios

• Gratuito e anônimo. O endpoint subjacente não exige login e não armazena nada.
• Determinístico. Os mapas são calculados por mecanismos testados; a camada de IA apenas interpreta.
• Honesto sobre limites. Hora de nascimento desconhecida degrada graciosamente em vez de inventar uma hora. Os mapas descrevem tendências e temas — não um destino fixo. Não é aconselhamento médico, jurídico ou financeiro.
• Aprenda os conceitos: O que é BaZi? · O que é um mapa natal? · O que é Zi Wei Dou Shu?
• Leituras completas, compatibilidade (sinastria / 合婚) e perguntas e respostas com IA: fatenava.com

Desenvolvimento

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

A variável de ambiente FATENAVA_API_BASE substitui a origem da API (para testes).

Licença

MIT