fatenava-mcp

fatenava-mcp

English | 繁體中文 | 简体中文 | 日本語 | 한국어

通过任何支持 MCP 的 AI Agent 排八字、紫微斗数和西方占星本命盘。

一个工具，三种确定性引擎，零配置：无需账号、API 密钥，也不会存储任何信息。 由 FateNava 的免费排盘 API 提供支持。

功能

输入出生信息（日期、时间、地点、性别），即可获取最多三种体系的结构化命盘数据：

体系	返回内容
BaZi 八字（四柱命理）	四柱（天干与地支）、日主、五行分布——根据出生地经度进行真太阳时校正后计算
Zi Wei Dou Shu 紫微斗数（紫微斗数）	十二宫及主星、命宫、四化
西方占星本命盘	回归黄道、Placidus 宫位制：上升星座、按星座和宫位排列的行星、元素与模式

数值是计算得出的，并非 AI 生成——相同的出生信息始终会得到相同的命盘。解读工作交由你的 AI Agent（或使用 FateNava 的免费解读工具）。

快速开始

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 / 通用 MCP 客户端

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

工具

• cast_chart — 根据一组出生信息排出八字（四柱）、紫微斗数和西方占星本命盘。通过真太阳时校正进行确定性计算；支持单行多语言出生信息文本或结构化字段。

cast_chart

描述出生信息有两种方式——任选其一：

1. 单行文本（最简单；API 会解析日期、时间、地点和性别，并将城市解析为坐标和时区）：

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

支持英文、中文、日文或韩文城市名称。

2. 结构化字段：

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

可选项：

• systems：["bazi", "ziwei", "astro"] — 选择部分体系以缩小响应内容（默认：全部三种）。
• birthTimeKnown: false — 适用于不知道准确出生时辰的情况。八字仍会返回三柱；不会猜测时辰，而是如实省略依赖时辰的信息。

响应结构

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

字段名称为英文；传统术语（天干、地支、宫位和星曜名称）会以原生汉字呈现——请让你的 Agent 将其翻译给用户。

说明与原则

• **免费且匿名。**底层接口无需登录，也不会存储任何信息。
• **确定性计算。**命盘由经过测试的引擎计算；AI 层只负责解读。
• **如实说明局限。**出生时间未知时会妥善处理，而不是编造时辰。命盘描述的是倾向和主题，并非固定命运。内容不构成医疗、法律或财务建议。
• 了解相关概念：什么是八字？ · 什么是本命盘？ · 什么是紫微斗数？
• 完整解读、合盘（西方合盘 / 合婚）和 AI 问答：fatenava.com

开发

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

FATENAVA_API_BASE 环境变量可用于覆盖 API 源站（用于测试）。

许可证

MIT