
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 分