紫微斗数排盘 MCP（ChatGPT Work）

此项目封装了 Renhuai123/ziwei-doushu 的 generateChart() 排盘算法，源代码快照为 9d98b3ae7fce298f751cb43c47783d6e84a7735d。工具返回原始结构化命盘；自然语言解读由 ChatGPT 根据命盘生成，并非原项目商业站的 AI 解读。

本地启动

需要 Node.js 20 或以上。进入解压后的目录执行：

npm install
npm run check
npm start

打开 http://localhost:8787/ 可检查服务状态。MCP 地址是 http://localhost:8787/mcp。

Related MCP server: Falcı Hatun MCP Server

接入网页版 ChatGPT Work

1. 将服务部署到持续运行且可从互联网访问的 HTTPS 地址。短期测试也可用 HTTPS 隧道映射本机的 8787 端口，但电脑或隧道停止后连接即失效。请给公开部署配置适当的访问控制；出生信息属于个人信息。

2. 在 ChatGPT 的 设置 → 安全与登录 中启用开发者模式。到 插件 页面添加 MCP 服务，填入 https://你的域名/mcp。名称可填“紫微斗数排盘”。

3. 新开 Work 对话，在 @ 菜单中选择该插件，输入：“用排盘工具排盘：公历 1995 年 8 月 12 日 14:30，女，出生地西安。请列出十二宫和四化，并区分命盘数据与主观解读。”

提供出生城市时，最好提供准确经度。工具未获得经度时不进行真太阳时校正；有经度时按仓库的 true-solar-time.ts 计算。日期须为公历。1986–1991 年中国夏令时默认自动处理；非中国出生应将 chinaDST 设为 false。晚子时默认按次日，闰月默认按 split，可在工具参数中调整。

若需要“以后随时都能用”，应选择长期在线的 Node.js 托管服务和固定域名。此压缩包提供服务代码，不包含托管账号、域名或已安装的 Work 插件。

本地验证

curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_ziwei_chart","arguments":{"year":1995,"month":8,"day":12,"clockHour":14,"clockMinute":30,"gender":"female","longitude":108.9}}}'

原仓库代码遵循其 LICENSE；此封装也随附该许可。排盘仅供文化和娱乐参考，不宜用于健康、财务等重大决定。