FateStar Ziwei

FateStar Ziwei

专为 Zi Wei 打造的托管 MCP，供 AI Agent 使用。一个 URL；无需本地服务、安装软件包、账号或 API 密钥，即可生成命盘并查看六个层级的运限。也提供 Agent Skill 和 REST API。

简体中文

无需登录即可使用命盘和六级运限。可选的郑大钱解读需要 FateStar API 密钥和额度。

立即试用

打开实时匿名命盘响应。无需账号或 API 密钥。该响应中的部分字段：

Solar 1990-7-23 | Lunar 一九九〇年六月初二
Five-elements class 土五局 | Life ruler 文曲 | Body ruler 火星
Life palace 己卯 | 廉贞 (平), 破军 (陷)
12 palaces | 5 detected patterns | 4 natal transformations

安装 Skill 或连接 MCP 端点后，告诉你的 Agent：

为一位出生于 1990 年 7 月 23 日上午 8:00 的男性排一张紫微斗数命盘，然后展示他的 2026 年运限。

Agent 会调用 FateStar 并返回：

• 一张包含 12 个宫位、星曜、亮度和四化的命盘；
• 提供经度和时区时进行的真太阳时校正；
• 大限、小限、流年、流月、流日和流时运限；
• 有效密钥和额度可用时提供的可选郑大钱解读。

如果实时结果对你有帮助，请为仓库点星。这有助于其他 Agent 开发者发现这个免费端点。

为什么选择 FateStar

FateStar 专注于单一用途：让 AI Agent 轻松使用紫微命盘数据，无需运行本地占星服务。

选择	适用场景
FateStar	你现在就需要托管的远程 MCP：一个 URL、匿名免费排盘、六级运限、原生结构化 MCP 输出，以及官方 Registry 收录。
Iztro	你需要一个开源紫微引擎，以便嵌入自己的应用、检查或修改。
Taibu 或 Horosa Skill	相比专注的托管紫微端点，你更偏好涵盖更多体系或可离线使用的玄学工具。

这些是不同的部署选择，并非声称某一派别或引擎普遍更准确。

快速开始

Agent Skill

GitHub CLI 2.90 或更高版本可将此 Skill 安装到 Codex、Claude Code、Cursor 和许多其他 Agent 中。

# Codex
gh skill install LouisLin0723/fatestar-ziwei ziwei-paipan --agent codex --scope user

# Claude Code
gh skill install LouisLin0723/fatestar-ziwei ziwei-paipan --agent claude-code --scope user

# Cursor
gh skill install LouisLin0723/fatestar-ziwei ziwei-paipan --agent cursor --scope user

重启 Agent，然后让它排一张紫微斗数命盘。规范版 Skill 位于 skills/ziwei-paipan。

如果你的 GitHub CLI 版本较旧，请升级，或将 skills/ziwei-paipan 目录复制到 Agent 的 Skill 目录中。

托管 MCP

无需本地服务。将远程端点添加到支持 Streamable HTTP 的客户端：

{
  "mcpServers": {
    "fatestar-ziwei": {
      "url": "https://www.fatestar.top/api/mcp"
    }
  }
}

该端点提供 ziwei_chart、ziwei_transits 和 ziwei_reading。前两个工具免费且无需身份验证。

tools/list 为每个工具声明了 outputSchema 和行为注解。调用成功后会同时返回原生 structuredContent 和旧版 JSON 文本，因此较新的 Agent 可以使用类型化字段，而较旧的客户端也能正常工作。

该服务已列入官方 MCP Registry，名称为 io.github.LouisLin0723/fatestar-ziwei。

REST API

无需账户即可免费请求排盘：

curl "https://www.fatestar.top/api/ziwei?year=1990&month=7&day=23&hour=8&gender=male"

完整 API 和客户端文档：fatestar.top/docs

选择集成方式

集成方式	适用场景	安装	免费排盘
Agent Skill	Codex、Claude Code、Cursor 及其他编码 Agent	gh skill install	是
托管 MCP	支持远程 HTTP 的 MCP 客户端	一个 URL	是
REST API	应用、脚本和后端服务	curl 或 HTTP 客户端	是

这三种方式都使用同一个 FateStar 引擎。请选择适合你的客户端的接口。

功能

功能	费用	说明
本命盘	免费	支持公历或农历输入、12 宫位、102 颗星曜、亮度、四化
六层运限	免费	大限、小限、年、月、日、时
真太阳时	免费	输入经度和时区后启用
郑大钱解读	积分	FateStar 知识引擎和托管解读服务

该 Skill 提供 Python、Node.js、PowerShell 和 Bash 客户端。Python 和 Node.js 客户端使用标准库，无需安装软件包。

CLI 示例

在已安装的 ziwei-paipan Skill 目录中运行以下命令：

# Free natal chart
python scripts/ziwei_cli.py chart \
  --year 1990 --month 7 --day 23 --hour 8 --gender male

# Free 2026 transits
python scripts/ziwei_cli.py transits \
  --year 1990 --month 7 --day 23 --hour 8 --gender male \
  --target-year 2026

# Hosted reading, requires FATESTAR_API_KEY
python scripts/ziwei_cli.py reading \
  --year 1990 --month 7 --day 23 --hour 8 --gender male \
  --question "Should I change jobs this year?"

使用 python scripts/ziwei_cli.py doc 查看离线接口参考。同一目录中还有功能相当的 Node.js、PowerShell 和 Bash 客户端。

API 密钥和计费

无论是否使用密钥，chart 和 transits 均免费。密钥仅用于将这些免费调用归属到你的账户。

reading 需要 FSFSKey，并且可能消耗积分。请在 FateStar 开发者中心创建密钥。请将其存放在源代码管理之外：

export FATESTAR_API_KEY="FSFSKey_your_key"

对于 MCP 客户端，仅在需要使用 ziwei_reading 时发送 Authorization: Bearer FSFSKey_your_key。切勿提交真实密钥或将其粘贴到问题中。

仓库结构

skills/ziwei-paipan/
├── SKILL.md
├── agents/openai.yaml
├── scripts/
│   ├── ziwei_cli.py
│   ├── ziwei_cli.js
│   ├── ziwei_cli.ps1
│   ├── ziwei_cli.sh
│   └── shared/

根目录中的 server.json 使用官方 MCP Registry 架构描述托管端点。

开发

python skills/ziwei-paipan/scripts/generate.py --check
python tests/live_contract_check.py
python skills/ziwei-paipan/scripts/ziwei_cli.py doc
node skills/ziwei-paipan/scripts/ziwei_cli.js doc
powershell -ExecutionPolicy Bypass -File skills/ziwei-paipan/scripts/ziwei_cli.ps1 doc
bash skills/ziwei-paipan/scripts/ziwei_cli.sh doc

四个客户端共用生成的常量和离线接口规范。请先编辑共享文件，再运行 generate.py，然后运行上述检查。 更完整的兼容性矩阵见 docs/TEST_PLAN.md。关于托管 MCP 的具体断言及其限制，请参阅 docs/VERIFICATION.md。

开源范围

此仓库包含 Agent Skill、四个轻量客户端、集成元数据和公开文档。不包含 FateStar 的服务端实现、私有提示词、郑大钱训练数据、检索语料库、评估集和计费控制。

仓库代码采用 MIT 许可证。FateStar 的品牌、托管服务和私有知识资产仍为专有内容。

贡献

欢迎提交错误报告、客户端示例和兼容性修复。提交拉取请求前，请阅读 CONTRIBUTING.md。安全问题请通过 SECURITY.md 报告，不要发布在公开问题中。