已经在跑 / 在做的连接器。点进去看它干什么、怎么配。
干支农历最怕两件事：年柱从哪天换、让谁去算。
网上能查到的历法数据，基本都是按正月初一换年干，术数上不对；而把规则丢给大模型现算，又容易一次一个结果。这个连接器不赌运气——底层是 55152 天逐日校验的历表（1900-01-01 ～ 2050-12-31），年柱一律以立春为界，查表直出，并直接给出当前节气的第几天。
四柱、农历日期与生肖、二十四节气、节气第几天一次返回，供奇门遁甲、紫微斗数、六爻等术数排盘取数使用。
基于 MCP 标准协议的个人知识库：AI 直接检索、读取、写入你的 markdown 笔记与知识图谱；一个 APIKEY 走遍所有 MCP 客户端（WorkBuddy、Claude 等），数据按账号严格隔离。
APIKEY 请在官网 memory.qianjilian.com 注册免费获取（手机号即可，控制台「个人信息」查看），注册即送 7 天体验。用户策略：关注公众号「千机连」即享会员，取消关注资格即失效。
两种调法：HTTP 网关是一条 URL，最省事，适合脚本 / 网页直接调；MCP 端点是给 AI 工作台装的，一次装好之后用自然语言就能问。
| 参数 | 必填 | 格式 / 取值范围 | 含义 |
|---|---|---|---|
| act | 是 | 固定 run | 动作：调用连接器 |
| cppid | 是 | 固定 china-lunar | 连接器代号 |
| apikey | 是 | 千机连接口密钥（注册即得） | 身份与计费凭据。不填密钥的匿名免费只走 MCP 端点，网关这条 URL 必须带 |
| westday | 是 | YYYY-MM-DD，如 2026-10-06；也认 2026-10-6、20261005 | 要换算的阳历（公历）日期，范围 1900-01-01 ～ 2050-12-31 |
| westh | 否 | 整数 0-23，不填默认 12；填错或越界按 12 算 | 小时，用来起时柱；填 23 按夜子时处理 |
端点：https://qianjilian.com/localxres/mcp/china-lunar/index.php 鉴权：Authorization: Bearer 你的密钥（可留空，留空按来源 IP 每天 3 次免费）
| 工具 | 参数 | 必填 | 格式 / 取值范围 | 含义 |
|---|---|---|---|---|
| lunar_convert | date | 是 | YYYY-MM-DD（也认 2026-10-6 / 20261005） | 单个阳历日期 → 四柱与农历 |
| hour | 否 | 0-23，默认 12 | 小时，起时柱 | |
| lunar_batch | dates | 是 | 日期数组，最多 30 个 | 批量换算，整批只算 1 次额度 |
| hour | 否 | 0-23，统一套用到整批 | 整批共用的小时 | |
| find_solar_term | year | 是 | 1900-2050 的年份 | 查该年节气对应的阳历日期 |
| term | 否 | 如 立春 / 清明 / 冬至 | 不填则返回该年全部二十四节气 |
| 字段 | 含义 |
|---|---|
| ganzhi.year | 年柱干支 —— 以立春为界换年（不是正月初一）。排八字四柱用这个 |
| ganzhi.month | 月柱干支 —— 以节气为界（不是农历初一） |
| ganzhi.day | 日柱干支 |
| ganzhi.hour | 时柱干支 —— 五鼠遁起，23 点按夜子时处理 |
| ganzhi_text | 四柱连写，如「丙午年丁酉月癸丑日庚申时」 |
| lunar.year_ganzhi | 农历年的干支，按正月初一起算 —— 与年柱不是一回事，立春到正月初一之间两者会差一年，属正常 |
| lunar.month / lunar.day | 农历月、日（汉字，闰月带「闰」字） |
| lunar.animal | 生肖 |
| term | 当天处在哪个节气 |
| term_day | 该节气的第几天 —— 奇门定局、排大运直接用这个数 |
| shichen | 时辰（子时 / 丑时…） |
| days_from_lichun | 距当年立春多少天，立春之前为负数 |
| quota | 免费额度：{by, key, used, limit, remain} —— 还剩几次 |
| ok / msg | ok=1 成功；ok=0 看 msg（日期格式不对 / 超出 1900-2050 / quota_exceeded 额度用完） |
上面这串就是 2026 年 10 月 6 日 15 点的真实返回：四柱丙午年丁酉月癸丑日庚申时，农历八月廿六，生肖马，正处在秋分的第 14 天。
对外只有一个入口，参数走 GET / POST，返回 JSON：