freebazi-mcp 是一个 Model Context Protocol（MCP）服务器，用于根据出生日期、时间和地点计算完整的中国八字（四柱）命盘。它封装了与 freebazi.com 相同的计算引擎：完全离线，校正真太阳时和历史日光节约时间，并与主流八字程序库逐字交叉验证。无需 API 密钥，无网络调用，全部在本机运行。需要 Node.js 18+。
用途：为八字排盘提供 MCP 工具接口，使 AI 代理或支持 MCP 的客户端能够直接计算并获取八字命盘信息，适用于需要集成八字分析能力的应用或对话场景。
主要能力：
- 四柱（年、月、日、时），每柱包含天干和地支。
- 日干（日主）以及每个字的十神。
- 藏干、纳音、十二长生。
- 五行分布（包括可见五行和含藏干的五行）。
- 神煞和地支关系（合、冲、刑、害）。
- 大运（运势柱）并标出当前运程，以及当年流年柱。
- 返回一个指向 freebazi.com 上完整交互命盘的链接。
- 附带 search_cities 工具，可按英文或中文名称搜索约 490 个世界主要城市，返回每个匹配项的国家、经度和 IANA 时区，便于将精确城市传递给 compute_bazi_chart。
使用方式： 可通过 npx 直接运行。配置到 Claude Desktop 时，将其加入 claude_desktop_config.json，提供命令和参数。其他 MCP 客户端（如 Cline、Continue、Cursor 等）采用相同的命令/参数格式。主要工具为 compute_bazi_chart，参数包括出生日期、时间和城市等，具体参数参考项目说明。
例如：计算 1990 年 6 月 15 日上午 9:30 在纽约出生的某人的八字命盘。服务器会解析纽约，应用真太阳时（上午 9:30 变为上午 8:34，提前 56 分钟，从而改变时柱），返回四柱 庚午 壬午 辛亥 壬辰，日主为辛（阴金），以及所有十神、五行、大运等信息。
适用场景： 适用于希望以编程方式或通过 AI 助手获取八字排盘结果的开发者、研究者或爱好者。可用于个人八字分析、学习八字知识（项目页面提供了 freebazi.com 上的交互计算器、指南和完整命盘链接，以及关于八字是什么、如何构建命盘、五行、日主、十神等说明页面），或集成到需要命盘计算能力的应用中。
限制：
- 需要 Node.js 18+。
- 工具仅描述命盘，不预测具体事件。八字是一个用于反思性格、倾向与时机的传统框架。
- 太阳能术语边界根据太阳视黄经和标准天文公式计算，时区（包括历史夏令时）从 IANA 数据库解析。引擎的四柱结果在数千个测试命盘中与主流库逐字一致。
- 城市数据来自 GeoNames（CC BY 4.0）。简体转繁体通过 OpenCC。
- 其他功能与价格等信息暂未提供。
