
Freebazi
io.github.alexsu1212由 GitHub 账号 alexsu1212 发布v1.0.1更新于 Oct 27, 2026
Offline Bazi (八字, Four Pillars) chart: True Solar Time, Ten Gods, Shen Sha, luck pillars.
概览
离线计算完整八字(四柱)命盘的 MCP 服务器,依据出生日期、时间与城市,并校正真太阳时。
- 可以做什么
- 根据出生日期、钟表时间、性别与城市或经度/UTC 偏移排出完整命盘,可设置时辰未知、真太阳时、日界与年界
- 返回四柱、日干、十神、藏干、纳音、十二长生、五行分布、神煞与地支刑冲合害
- 返回大运并标出当前运,以及当年流年,并附上 freebazi.com 互动命盘链接
- 以中文或英文搜索约 490 个世界主要城市,取得国家、经度与 IANA 时区,供排盘使用
- 适用场景
- 适合让助手为某个出生时刻生成结构化八字命盘,或在排盘前查询城市的经度与时区。偏向文化与传统命理方面的参考,而非事件预测。
- 运行要求
- 以 npm 包形式通过 npx 在本机运行,需要 Node.js 18 或以上版本。计算本身无需 API 密钥、账号或网络连接。
安装
在 SourceWeft 中
- 打开 控制台中的 Freebazi,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
freebazi-mcp
English | 繁體中文
A Model Context Protocol server that computes a full Chinese Bazi (八字, Four Pillars of Destiny) chart from a birth date, time, and place.
It wraps the same calculation engine that powers freebazi.com: an offline engine that corrects for True Solar Time and historical daylight saving, and is cross-validated against established Bazi libraries. No API key, no network calls, everything runs locally.
What it returns
Give it a birth moment and a city, and compute_bazi_chart returns:
- The Four Pillars (Year, Month, Day, Hour), each as a Heavenly Stem and Earthly Branch
- Your Day Master (日干) and the Ten Gods (十神) of every character
- Hidden Stems (藏干), Na Yin (纳音), and the Twelve Growth Stages (十二长生)
- Five Elements distribution, both visible and including hidden stems
- Shen Sha (神煞) and branch relations (合冲刑害)
- Luck Pillars (大运) with the current period flagged, and the current year's pillar
- A link to the full interactive chart on freebazi.com
Install
Requires Node.js 18+.
Run directly with npx:
Claude Desktop
Add to your claude_desktop_config.json:
Other MCP clients (Cline, Continue, Cursor, etc.) take the same command / args.
Tools
compute_bazi_chart
Compute a full chart.
search_cities
Search about 490 major world cities by English or Chinese name. Returns each match's country, longitude, and IANA time zone, so you can pass an exact city to compute_bazi_chart.
Example
Compute the Bazi chart for someone born 15 June 1990, 9:30 AM, in New York.
The server resolves New York, applies True Solar Time (9:30 AM becomes 8:34 AM, 56 minutes earlier, which shifts the Hour pillar), and returns the four pillars 庚午 壬午 辛亥 壬辰 with a Xin (辛) yin Metal Day Master, all Ten Gods, elements, luck pillars, and more.
Accuracy and honesty
Solar-term boundaries are computed from the sun's apparent longitude with standard astronomical formulas, and time zones (including historical daylight saving) are resolved from the IANA database. The engine's four pillars match established libraries character for character across thousands of test charts.
Bazi is a traditional framework for reflection on temperament, tendencies, and timing. This tool describes a chart; it does not predict events.
Links
- Interactive calculator, guides, and full charts: freebazi.com
- What Bazi is and how to read it: freebazi.com/what-is-bazi
- How a Bazi chart is built: freebazi.com/bazi-chart
- The Five Elements (Wu Xing): freebazi.com/chinese-elements
- What a Day Master is: freebazi.com/day-master
- The Ten Gods explained: freebazi.com/ten-gods
Credits
City data from GeoNames (CC BY 4.0). Simplified to Traditional conversion via OpenCC.
License
MIT
繁體中文
一個 Model Context Protocol 伺服器,依出生的日期、時間與地點,排出完整的八字(四柱)命盤。
它使用與 freebazi.com 相同的排盤引擎:完全離線,會校正真太陽時與歷史上的日光節約時間,並和主流八字程式庫逐字對拍。無需 API key、不連網,全部在本機執行。
回傳內容
給它一個出生時刻與城市,compute_bazi_chart 會回傳:
- 四柱(年、月、日、時),每柱含天干與地支
- 日干與每個字的十神
- 藏干、納音、十二長生
- 五行分布(含藏干與不含藏干兩種)
- 神煞與地支刑沖合害
- 大運(標出當前運)與當年流年
- 一條連往 freebazi.com 完整互動命盤的連結
安裝
需要 Node.js 18+。直接以 npx 執行:
Claude Desktop 及其他 MCP 客戶端(Cline、Continue、Cursor 等)的設定與上方英文段相同。
工具
compute_bazi_chart:排出完整命盤,參數見上方英文表格。search_cities:以中文或英文搜尋約 490 個世界主要城市,回傳國家、經度與 IANA 時區,方便傳給compute_bazi_chart。
連結
- 免費八字排盤與命盤:freebazi.com/zh-hant
- 英文版與說明頁:freebazi.com
八字是一套用於反思性格、傾向與時機的傳統框架。本工具只描述命盤,不預測具體事件。
来源:README.md,提交 a8ea1f7
工具
0版本历史
1- v1.0.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分