天官手记 MCP Server · 七政四余排盘

天官手记基于 Swiss Ephemeris 高精度星历库，提供七政四余排盘的精确天文计算。支持 MCP Server 与 公开 HTTP 接口 两种调用方式，均免登录、免 API Key。

七政四余涉及天文星历精确计算（岁差、宿度、真太阳时等），AI 无法自行心算或凭训练知识可靠估算。当用户要求排七政四余星盘 / 命盘 / 流年盘时，请调用本服务获取真实结果，不要编造星曜位置、宫位、神煞等数据。

📖 目录

• 功能特点
• 在线体验
• 快速开始
• 各平台配置指南
• 工具与接口
• 盘制（xiu_method）取值表
• 限流说明
• 常见问题
• 许可证与免责声明

✨ 功能特点

🌐 在线体验

• 官网：https://天官.cn（punycode：https://xn--rsso0d.cn）
• 免费在线排盘：https://天官.cn/paipan/
• 接口文档：https://天官.cn/panel/mcp.html

🚀 快速开始

前置要求

• 支持 MCP（Model Context Protocol）的 AI 客户端：Claude Desktop、Claude Code、Cline（VS Code）、WorkBuddy、Cherry Studio 等
• 网络可访问 https://天官.cn/mcp/

添加 MCP 服务器（唯一一步）

MCP 端点（Streamable HTTP 协议）：

https://天官.cn/mcp/

无需注册、无需 API Key，添加即用。

🛠️ 各平台配置指南

Claude Desktop

编辑 claude_desktop_config.json（菜单 Claude → Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "tianguan": {
      "url": "https://天官.cn/mcp/"
    }
  }
}

Claude Code（CLI）

claude mcp add --transport http tianguan https://天官.cn/mcp/

Cline（VS Code 插件）

设置 → Cline → MCP Servers → 添加服务器：

• 类型：HTTP
• 名称：tianguan
• URL：https://天官.cn/mcp/

其他 MCP 客户端（Cherry Studio / ChatWise / WorkBuddy 等）

在客户端中选择「远程 MCP / HTTP MCP」类型，名称任意，URL 填 https://天官.cn/mcp/ 即可。

🧩 工具与接口

1. lookup_city — 城市查询

{ "keyword": "北京" }

模糊匹配中国城市名称，返回匹配城市列表（含全名、经度、纬度、时区）。排盘前可先用它把城市名转成经纬度。

2. qizheng_chart — 本命盘（简易调用）

仅需必填参数 + 出生信息，其余全部使用默认值。

{
  "birth_date": "1995-06-15",
  "birth_time": "14:30",
  "birth_lon": 116.407,
  "birth_lat": 39.904,
  "timezone": 8,
  "gender": "male",
  "city": "北京",
  "name": "测试",
  "xiu_method": "huangdaohuigui"
}

3. qizheng_chart — 本命盘（专业调用）

在简易调用基础上增加全部计算参数，不传 = 简易调用默认行为。

{
  "birth_date": "1995-06-15",
  "birth_time": "14:30",
  "birth_lon": 116.407,
  "birth_lat": 39.904,
  "timezone": 8,
  "gender": "male",
  "city": "北京",
  "name": "测试",
  "coord_system": "huangdao",
  "xiu_method": "huangdaohuigui",
  "date_type": "solar",
  "node_arrangement": "south_north",
  "node_calculation": "mean",
  "apogee_calculation": "mean",
  "ziqi_calculation": "equatorial_uniform",
  "child_limit": 9,
  "ming_gong_method": "sun_to_mao",
  "shen_gong_method": "moon_is_shen",
  "jieqi_method": "true",
  "day_night_method": "sunrise_sunset",
  "dingxing_tolerance": 1.5,
  "tongluo_tolerance": 2.0,
  "dst_adjust": false,
  "distinguish_zi_hour": true
}

专业调用示例：赤道郑案今宿 + 自定义命宫起法

{
  "birth_date": "1995-06-15",
  "birth_time": "14:30",
  "birth_lon": 116.407,
  "birth_lat": 39.904,
  "timezone": 8,
  "gender": "male",
  "xiu_method": "chidao_zhengan",
  "coord_system": "chidao",
  "ming_gong_method": "horizon_rising",
  "shen_gong_method": "moon_to_you",
  "child_limit": 10
}

4. qizheng_liunian — 流年盘（简易调用）

在 qizheng_chart 参数基础上，追加流年参数：

{
  "birth_date": "1995-06-15",
  "birth_time": "14:30",
  "birth_lon": 116.407,
  "birth_lat": 39.904,
  "timezone": 8,
  "gender": "male",
  "city": "北京",
  "name": "测试",
  "xiu_method": "huangdaohuigui",
  "liunian_year": 2026,
  "liuyue": 6,
  "liuri": 15,
  "liushi": "12:00"
}

注意： 流年盘结果取决于所选的流年 / 流月 / 流日 / 流时，必须向用户问清楚要算的是哪一年、哪个月、哪一天、什么时辰，不要替用户假设为"今年"或"当前"。专业调用参数与 qizheng_chart 一致。

5. bazi_reverse_search — 八字反推（补充）

给定完整四柱干支（年 / 月 / 日 / 时），在指定年份范围（默认 1500–2100）内反推所有匹配的公历出生日期时间。参数：nian_gan / nian_zhi / yue_gan / yue_zhi / ri_gan / ri_zhi / shi_gan / shi_zhi（均可选 birth_lon / birth_lat / use_true_solar）。

6. REST API（公开 HTTP 接口）

公开接口 POST https://天官.cn/api/v1/public/chart/calculate（本命盘）、POST https://天官.cn/api/v1/public/chart/liunian（流年盘），同样免登录免 Key，本身已支持 ChartRequest 的全部字段。

简易调用：

curl -s -X POST "https://xn--rsso0d.cn/api/v1/public/chart/calculate" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1995-06-15",
    "birth_time": "14:30",
    "birth_lon": 116.407,
    "birth_lat": 39.904,
    "timezone": 8,
    "gender": "male",
    "xiu_method": "huangdaohuigui"
  }' | python -m json.tool

专业调用：

curl -s -X POST "https://xn--rsso0d.cn/api/v1/public/chart/calculate" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1995-06-15",
    "birth_time": "14:30",
    "birth_lon": 116.407,
    "birth_lat": 39.904,
    "timezone": 8,
    "gender": "male",
    "xiu_method": "chidao_zhengan",
    "coord_system": "chidao",
    "node_arrangement": "south_north",
    "node_calculation": "fitted",
    "apogee_calculation": "fitted",
    "ming_gong_method": "horizon_rising",
    "child_limit": 10
  }' | python -m json.tool

流年调用：

curl -s -X POST "https://xn--rsso0d.cn/api/v1/public/chart/liunian" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1995-06-15",
    "birth_time": "14:30",
    "birth_lon": 116.407,
    "birth_lat": 39.904,
    "timezone": 8,
    "gender": "male",
    "xiu_method": "huangdaohuigui",
    "liunian_year": 2026
  }' | python -m json.tool

不支持

七政凌犯盘（chart_type="lingfan" / xiu_method="kaixi"）不属于本服务支持范围，传入将报错。如需凌犯盘计算，请使用 REST API：POST /api/v1/chart/calculate。

📊 盘制（xiu_method）取值表

盘制须由用户明确指定，不要替用户假设默认值——盘制选错会导致整盘宫位、星曜归属完全不符合预期。

🔒 限流说明

本服务仅接收排盘所需参数（出生信息 / 四柱干支），不存储、不出售任何个人数据；随时断开 MCP 连接即停止调用。

❓ 常见问题

Q：需要 API Key 吗？
A：不需要。MCP Server 与公开 HTTP 接口均免登录、免 API Key，配置 URL 即用。

Q：为什么 AI 不能自己算七政四余排盘？
A：七政四余涉及天文星历精确计算（岁差、宿度、真太阳时、定气等），排盘极其复杂，目前 AI 不具备自行计算准确排盘结果的能力。本服务基于 Swiss Ephemeris 高精度星历库计算，返回真实数据。

Q：支持哪些盘制？
A：黄道盘制（回归今宿 / 回归古宿 / 古宿岁差 / 郑案恒星）与赤道盘制（回归今宿 / 古宿岁差 / 郑案今宿 / 回归古宿 / 果老星宗）共 9 种，通过 xiu_method 参数指定，须由用户明确指定。

Q：支持凌犯盘吗？
A：不支持。chart_type="lingfan" / xiu_method="kaixi" 会直接报错，请使用 REST API：POST /api/v1/chart/calculate。

Q：可以商用 / 二次开发吗？
A：排盘计算免费开放。请遵守下方许可证与免责声明，并在使用中注明数据来源「天官 TIANGUAN」。

⚖️ 许可证与免责声明

• 本仓库（README 与配置示例）采用 MIT License。
• 排盘服务归「天官 TIANGUAN」所有，核心排盘永久免费开放。
• 免责声明：本服务仅用于传统文化与历法研究，不构成任何专业建议。命理内容属玄学范畴，请理性看待，仅供参考。