关于 freebazi
freebazi 是本地运行的八字排盘 MCP 服务,根据出生日期、时间和地点计算四柱及相关命理信息。它校正真太阳时和历史夏令时,无需 API 密钥或网络连接。
主要功能
- 01计算四柱与日主
- 02分析十神和五行分布
- 03纳入真太阳时校正
- 04处理历史夏令时
- 05计算大运与流年
- 06搜索城市时区信息
适用场景
- 01按出生信息生成八字命盘
- 02比较不同日期边界规则
- 03查询城市经度和时区
MCP 相关
该 MCP 服务提供 `compute_bazi_chart` 和 `search_cities` 工具,供客户端计算命盘及查询城市信息;计算在本地完成,无需网络调用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
2收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| day | integer | 是 | 出生日期,1-31 |
| city | string | 否 | 出生城市名称,例如 'Taipei' 或 'New York'。解析为用于真太阳时计算的经度和 IANA 时区。不确定时请先使用 search_cities。 |
| hour | integer | 否 | 出生小时,0-23(记录的当地钟表时间) |
| year | integer | 是 | 出生年份,例如 1990 |
| month | integer | 是 | 出生月份,1-12 |
| gender | enum | 是 | 用于确定大运方向male | female |
| minute | integer | 否 | 出生分钟,0-59 |
| dayRule | enum | 否 | 新的一天开始时间:23:00 子时(默认)或午夜zi23 | midnight |
| yearRule | enum | 否 | 年份分界:立春(默认)或农历新年lichun | cny |
| longitude | number | 否 | 出生经度,东经度数(负数 = 西经)。替代城市参数。 |
| utcOffset | number | 否 | UTC 偏移小时数(例如中国为 8)。未提供城市时与 longitude 一起使用。 |
| timeUnknown | boolean | 否 | 如果出生时间未知,则为 true;此时的时柱为暂定值 |
| trueSolarTime | boolean | 否 | 应用真太阳时校正(推荐) |
详细介绍
freebazi-mcp
English | 繁體中文
一个 Model Context Protocol 服务,可根据出生日期、时间和地点计算完整的中国 Bazi(八字,Four Pillars of Destiny)命盘。
它封装了为 freebazi.com 提供支持的同一套计算引擎:一个离线引擎,可校正真太阳时和历史上的夏令时,并经过成熟八字库的交叉验证。无需 API 密钥,无需网络调用,所有计算均在本地运行。
返回内容
提供出生时间和城市后,compute_bazi_chart 会返回:
- 四柱(年、月、日、时),每柱由一个天干和一个地支组成
- 日主(日干)和每个字对应的十神
- 藏干、纳音和十二长生
- 五行分布,包括可见五行和藏干五行
- 神煞和地支关系(合冲刑害)
- 大运,并标出当前运程,以及流年年柱
- freebazi.com 上完整交互式命盘的链接
安装
需要 Node.js 18+。
直接使用 npx 运行:
npx freebazi-mcp
Claude Desktop
将以下内容添加到 claude_desktop_config.json:
{
"mcpServers": {
"freebazi": {
"command": "npx",
"args": ["-y", "freebazi-mcp"]
}
}
}
其他 MCP 客户端(Cline、Continue、Cursor 等)使用相同的 command / args。
工具
compute_bazi_chart
计算完整命盘。
| 参数 | 类型 | 说明 |
|---|---|---|
year、month、day | number | 出生日期 |
hour、minute | number | 记录的当地钟表时间(如果 timeUnknown,则省略) |
gender | "male" | "female" | 用于确定大运方向 |
city | string | 例如 "Taipei"、"New York"。解析为经度和时区,用于计算真太阳时 |
longitude、utcOffset | number | city 的替代参数 |
timeUnknown | boolean | 时柱标记为待定 |
trueSolarTime | boolean | 默认为 true |
dayRule | "zi23" | "midnight" | 日界线,默认为 23:00 |
yearRule | "lichun" | "cny" | 年界线,默认为立春 |
search_cities
按英文或中文名称搜索约 490 个世界主要城市。返回每个匹配项的国家、经度和 IANA 时区,以便将准确的城市传给 compute_bazi_chart。
示例
计算一位出生于 1990 年 6 月 15 日上午 9:30、地点为纽约的人的八字命盘。
服务会解析纽约的位置,应用真太阳时(上午 9:30 调整为上午 8:34,提前 56 分钟,因此时柱会变化),并返回四柱庚午 壬午 辛亥 壬辰,日主为辛金,以及所有十神、五行、大运等信息。
准确性与说明
节气边界根据太阳视黄经使用标准天文公式计算,时区(包括历史夏令时)则依据 IANA 数据库解析。在数千个测试命盘中,该引擎计算出的四柱与成熟库逐字一致。
八字是一种用于反思性情、倾向和时机的传统框架。此工具用于描述命盘,不会预测事件。
链接
- 交互式计算器、指南和完整命盘:freebazi.com
- 八字是什么,以及如何解读:freebazi.com/what-is-bazi
- 八字命盘的构成:freebazi.com/bazi-chart
- 五行:freebazi.com/chinese-elements
- 什么是日主:freebazi.com/day-master
- 十神详解:freebazi.com/ten-gods
致谢
城市数据来自 GeoNames(CC BY 4.0)。简体中文转繁体中文使用 OpenCC。
许可证
MIT
繁體中文
一個 Model Context Protocol 伺服器,依出生的日期、時間與地點,排出完整的八字(四柱)命盤。
它使用與 freebazi.com 相同的排盤引擎:完全離線,會校正真太陽時與歷史上的日光節約時間,並和主流八字程式庫逐字對拍。無需 API key、不連網,全部在本機執行。
回傳內容
給它一個出生時刻與城市,compute_bazi_chart 會回傳:
- 四柱(年、月、日、時),每柱含天干與地支
- 日干與每個字的十神
- 藏干、納音、十二長生
- 五行分布(含藏干與不含藏干兩種)
- 神煞與地支刑沖合害
- 大運(標出當前運)與當年流年
- 一條連往 freebazi.com 完整互動命盤的連結
安裝
需要 Node.js 18+。直接以 npx 執行:
npx freebazi-mcp
Claude Desktop 及其他 MCP 客戶端(Cline、Continue、Cursor 等)的設定與上方英文段相同。
工具
compute_bazi_chart:排出完整命盤,參數見上方英文表格。search_cities:以中文或英文搜尋約 490 個世界主要城市,回傳國家、經度與 IANA 時區,方便傳給compute_bazi_chart。
連結
- 免費八字排盤與命盤:freebazi.com/zh-hant
- 英文版與說明頁:freebazi.com
八字是一套用於反思性格、傾向與時機的傳統框架。本工具只描述命盤,不預測具體事件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。