mcpField
F
freebazi

freebazi

本地服务
github.com/alexsu1212游戏娱乐08 周前更新

关于 freebazi

freebazi 是本地运行的八字排盘 MCP 服务,根据出生日期、时间和地点计算四柱及相关命理信息。它校正真太阳时和历史夏令时,无需 API 密钥或网络连接。

主要功能

  1. 01计算四柱与日主
  2. 02分析十神和五行分布
  3. 03纳入真太阳时校正
  4. 04处理历史夏令时
  5. 05计算大运与流年
  6. 06搜索城市时区信息

适用场景

  1. 01按出生信息生成八字命盘
  2. 02比较不同日期边界规则
  3. 03查询城市经度和时区

MCP 相关

该 MCP 服务提供 `compute_bazi_chart` 和 `search_cities` 工具,供客户端计算命盘及查询城市信息;计算在本地完成,无需网络调用。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"alexsu1212-freebazi": {
"command": "npx",
"args": [
"-y",
"freebazi-mcp"
]
}
}
}
启动命令npx -y freebazi-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmfreebazi-mcp1.0.1

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
dayinteger是出生日期,1-31
citystring否出生城市名称,例如 'Taipei' 或 'New York'。解析为用于真太阳时计算的经度和 IANA 时区。不确定时请先使用 search_cities。
hourinteger否出生小时,0-23(记录的当地钟表时间)
yearinteger是出生年份,例如 1990
monthinteger是出生月份,1-12
genderenum是用于确定大运方向male | female
minuteinteger否出生分钟,0-59
dayRuleenum否新的一天开始时间:23:00 子时(默认)或午夜zi23 | midnight
yearRuleenum否年份分界:立春(默认)或农历新年lichun | cny
longitudenumber否出生经度,东经度数(负数 = 西经)。替代城市参数。
utcOffsetnumber否UTC 偏移小时数(例如中国为 8)。未提供城市时与 longitude 一起使用。
timeUnknownboolean否如果出生时间未知,则为 true;此时的时柱为暂定值
trueSolarTimeboolean否应用真太阳时校正(推荐)

详细介绍

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、daynumber出生日期
hour、minutenumber记录的当地钟表时间(如果 timeUnknown,则省略)
gender"male" | "female"用于确定大运方向
citystring例如 "Taipei"、"New York"。解析为经度和时区,用于计算真太阳时
longitude、utcOffsetnumbercity 的替代参数
timeUnknownboolean时柱标记为待定
trueSolarTimeboolean默认为 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 数据库解析。在数千个测试命盘中,该引擎计算出的四柱与成熟库逐字一致。

八字是一种用于反思性情、倾向和时机的传统框架。此工具用于描述命盘,不会预测事件。

链接

致谢

城市数据来自 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。
連結

八字是一套用於反思性格、傾向與時機的傳統框架。本工具只描述命盤,不預測具體事件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。