小 道生活 · 福泽

小道排盘接口（MCP）使用说明

小道排盘接口，是给 AI 助手用的排盘工具。你的 AI 助手可以直接调用小道，排八字、排奇门、换算真太阳时。

地址：https://xiaodaox.com/mcp

不用登录，不用注册。

只给排盘，不给解读。盘怎么解，由你的 AI 助手来讲。

怎么接

在 Claude 里

  1. 打开 Customize → Connectors。
  2. 点 + Add，再点 Add custom connector。
  3. 名称随便取，比如「小道排盘」；地址填 https://xiaodaox.com/mcp，点 Continue。
  4. 如果让你选认证方式，选 No sign in。点 Add。
  5. 开一个新对话，点输入框左下角的 +，选 Connectors，把「小道排盘」打开。
  • Team 和 Enterprise：先由组织的 Owner 在 Organization settings → Connectors 里添加，成员再到 Customize → Connectors 点 Connect。
  • 免费版 Claude 账号只能加一个自定义连接器。
  • 在一个 Claude 账号里加好，网页版、桌面版和手机版都能用。
  • Claude 里的按钮和菜单以 Claude 当时的界面为准。

在别的 AI 客户端里

支持远程 MCP 的客户端，把同一个地址填到它添加远程 MCP 服务的地方。填在哪里各家不同，请看那个客户端自己的说明。

比如桌面客户端 Cherry Studio：在客户端里添加一个远程 MCP 服务器，类型选 Streamable HTTP，地址填 https://xiaodaox.com/mcp。小道不用登录，也不用 API 密钥，认证和请求头都不用填。添加后启用它，再在对话或助手里把它选上。Cherry Studio 官方文档写的添加路径是 Settings → MCP → MCP Servers → Add；类型的叫法和字段名以它当时的界面为准。

小道用的是标准的远程 MCP（Streamable HTTP）；只支持旧版 SSE 传输的客户端接不上。

有哪些工具

一共四个，都只读：只查询和计算，不改任何东西。

工具做什么要给什么回什么
search_birth_place
查出生地		按地名查小道的出生地库，拿到出生地编号。排八字、换算真太阳时都要用这个编号query：地名（必填，最长 120 字）
language：zh-CN 或 en，默认 en		最多 80 个候选：编号、中文名、英文名、国家、一级行政区
bazi_chart
排八字		排一张完整的八字盘必填：placeId 出生地编号、date 出生日期、time 出生时间（HH:MM）、sex（MALE 或 FEMALE）
选填：calendar（SOLAR 公历，默认；LUNAR 农历，要同时给 isLeapMonth）、daylightSaving、earlyLateZi、boundaryChoices、focusDate、detailYears、allDaysOfMonth、language		四柱和每柱详情（主星、藏干、副星、星运、自坐、空亡、纳音、神煞）、农历、真太阳时、原局的合冲刑害破、胎元、命宫、身宫、月令的旺相休囚死、起运和顺逆、十二步大运（每步的干支、起止年、详情、和原局的关系、每年干支）、起运前的流年，以及焦点那一天的流年、流月、流日、流时
qimen_chart
奇门排盘		排一局时家奇门（拆补法，转盘）。小道只有这一种排法必填：date 日期、time 时间（HH:MM），是起局那一刻的当地钟表时间
选填：placeId（所在地或事件地；不填就用小道起局的参考地点，返回里会写明）、daylightSaving、birthYearPillar（命主出生年的年柱干支，如「庚午」，用来看年命）、language		四柱、节气、阴阳遁和局数、旬首、值符、值使、伏吟反吟、五不遇时、空亡、驿马，九宫每一宫的星、门、神、天盘干、地盘干、寄干、暗干和门迫、击刑、入墓等标记；给了出生年柱的，再加年命落在哪一宫
true_solar_time
真太阳时换算		把出生地当时的钟表时间换成真太阳时必填：placeId、date、time
选填：calendar、isLeapMonth、daylightSaving、earlyLateZi、boundaryChoices、language		钟表时间、历史时区和偏移、当时是不是夏令时、真太阳时（精确到分）、子时口径。不回四柱和农历

用的时候要知道的

  • 时间填出生地当时的钟表时间。时区和夏令时按出生地当年的历史规定算，不按今天的。
  • 日期支持 1801 年到 2099 年，公历、农历都是；超出会回「输入有误」。
  • 真太阳时 = 钟表时间去掉夏令时，加经度修正（每度 4 分钟），再加均时差。
  • 子时默认 23 点换日，跟小道网站一样；八字想按零点换日，传 earlyLateZi: true。奇门固定 23 点换日，不能选。
  • 缺了信息，接口不会瞎猜，会请你补：钟表时间出现两次（秋天回拨）时，请选是不是夏令时；农历日期要说明是不是闰月；出生时间靠近时辰、换日或节气交界时，请选按当前时间（SAME）还是交界的另一边（OTHER）。春天跳过的那一小时不存在，不排。
  • 八字默认回「一生的骨架」加「出生地此刻」那一天；要别的日子，传 focusDate；要某几年的逐年详情，传 detailYears（一次最多 10 年）；要整个流月每一天，传 allDaysOfMonth。
  • 排盘文字是中文，干支、十神、神煞用这门学问通用的写法；同一份内容另有结构化数据。language 选 en 时，多一段英文的口径说明和行名对照。
  • 每次返回的开头有一段「口径」，写明这张盘按什么规则算的；末尾有几句给 AI 的话：这是排盘，不是断语，请按自己的学问解读并说清依据；不断死亡和寿数、不做医学诊断、不给投资借贷赌博的具体建议等。
  • 返回里附一个回小道的链接，只带来源标记，不带你的出生信息。

怎么问

下面的出生信息都是虚构的。

  • 「帮我排一个八字：男，1990 年 5 月 12 日早上 8 点 30 分，成都出生。」AI 助手会先查出生地，再排八字，把排好的盘讲给你。
  • 「用小道排一局奇门，现在，上海。」
  • 「1985 年 7 月 1 日凌晨 2 点 30 分，在纽约出生，真太阳时是几点？」
  • 「接着看我这张八字盘 2027 年 3 月 15 日那一天的流日。」

数据怎么处理

以下是《小道隐私政策》第二条第 9 项的要点，完整写法见隐私政策。

  • 使用不需要登录。小道不识别你的身份，不收集姓名或其他自由填写的内容，也不与任何账号关联。
  • 你的 AI 助手把排盘所需的信息发给小道：八字需要出生地、出生日期和时间、历法、性别和排盘选项；奇门需要起局那一刻的当地钟表时间，可以再给所在地或事件地、命主出生年的年柱干支；钟表时间出现两次时，还要选是不是夏令时。小道只用来排出这一次的盘，再把完整的排盘信息回给你的 AI 助手。
  • 这一次排盘只由程序完成，不调用小道推理引擎的算力提供方。这些信息和排出的盘不存进数据库，不写在硬盘上，不写进程序日志；每次请求处理完，结果就清空，不留存。
  • 跟网站其他部分一样，服务器访问日志会记 IP 地址（只保留前段）、请求的路径、状态码、耗时和浏览器标识；不记请求内容，你发送的信息不在里面。
  • 小道按 AI 助手自报的名称，把它归入几个类别，连同协议版本暂存在内存里，24 小时后过期；里面没有你发送的信息，自报的原名也不保留。
  • 你的 AI 助手怎么保存和使用你跟它的对话，由它的提供方的隐私政策管，不适用小道的政策。
  • 请求由位于新加坡的服务器处理。

隐私政策：《小道隐私政策》。联系方式：support@xiaodaox.com。

限制和出错

  • 接口里只有上面四个工具。小道网站上的八字报告、千问、今日运道等功能，不在接口里。
  • 所有人共用一个调用额度。用的人多的时候，会回「现在用的人太多，过会儿再试」，过一会儿再来就行。
  • 直接在浏览器页面里发请求的客户端，目前只放行 claude.ai 和 chatgpt.com 两个来源；别的这类客户端连不上的话，写信到 support@xiaodaox.com。桌面端、命令行这类不带来源的客户端不受影响。
  • 出错时，返回里会写原因：
    • 「输入有误，请检查出生地编号、日期、时间和选择项」：出生地编号要用 search_birth_place 查到的；日期写 YYYY-MM-DD，时间写 HH:MM；性别只能是 MALE 或 FEMALE。
    • 「focusDate 或 detailYears 超出起运前与十二步大运的覆盖范围」：换一个在这张盘大运范围内的日期或年份。
    • 「暂时无法完成换算或排盘，请稍后再试」：过一会儿再试。
    • 「需要补充……」：不是出错，是缺信息，按提示补上再调一次。
  • 用不通，或者想反馈：support@xiaodaox.com。
排盘接口

小道排盘接口（MCP）使用说明

小道排盘接口，是给 AI 助手用的排盘工具。你的 AI 助手可以直接调用小道，排八字、排奇门、换算真太阳时。

地址：https://xiaodaox.com/mcp

不用登录，不用注册。

只给排盘，不给解读。盘怎么解，由你的 AI 助手来讲。

怎么接

在 Claude 里

  1. 打开 Customize → Connectors。
  2. 点 + Add，再点 Add custom connector。
  3. 名称随便取，比如「小道排盘」；地址填 https://xiaodaox.com/mcp，点 Continue。
  4. 如果让你选认证方式，选 No sign in。点 Add。
  5. 开一个新对话，点输入框左下角的 +，选 Connectors，把「小道排盘」打开。
  • Team 和 Enterprise：先由组织的 Owner 在 Organization settings → Connectors 里添加，成员再到 Customize → Connectors 点 Connect。
  • 免费版 Claude 账号只能加一个自定义连接器。
  • 在一个 Claude 账号里加好，网页版、桌面版和手机版都能用。
  • Claude 里的按钮和菜单以 Claude 当时的界面为准。

在别的 AI 客户端里

支持远程 MCP 的客户端，把同一个地址填到它添加远程 MCP 服务的地方。填在哪里各家不同，请看那个客户端自己的说明。

比如桌面客户端 Cherry Studio：在客户端里添加一个远程 MCP 服务器，类型选 Streamable HTTP，地址填 https://xiaodaox.com/mcp。小道不用登录，也不用 API 密钥，认证和请求头都不用填。添加后启用它，再在对话或助手里把它选上。Cherry Studio 官方文档写的添加路径是 Settings → MCP → MCP Servers → Add；类型的叫法和字段名以它当时的界面为准。

小道用的是标准的远程 MCP（Streamable HTTP）；只支持旧版 SSE 传输的客户端接不上。

有哪些工具

一共四个，都只读：只查询和计算，不改任何东西。

工具做什么要给什么回什么
search_birth_place
查出生地		按地名查小道的出生地库，拿到出生地编号。排八字、换算真太阳时都要用这个编号query：地名（必填，最长 120 字）
language：zh-CN 或 en，默认 en		最多 80 个候选：编号、中文名、英文名、国家、一级行政区
bazi_chart
排八字		排一张完整的八字盘必填：placeId 出生地编号、date 出生日期、time 出生时间（HH:MM）、sex（MALE 或 FEMALE）
选填：calendar（SOLAR 公历，默认；LUNAR 农历，要同时给 isLeapMonth）、daylightSaving、earlyLateZi、boundaryChoices、focusDate、detailYears、allDaysOfMonth、language		四柱和每柱详情（主星、藏干、副星、星运、自坐、空亡、纳音、神煞）、农历、真太阳时、原局的合冲刑害破、胎元、命宫、身宫、月令的旺相休囚死、起运和顺逆、十二步大运（每步的干支、起止年、详情、和原局的关系、每年干支）、起运前的流年，以及焦点那一天的流年、流月、流日、流时
qimen_chart
奇门排盘		排一局时家奇门（拆补法，转盘）。小道只有这一种排法必填：date 日期、time 时间（HH:MM），是起局那一刻的当地钟表时间
选填：placeId（所在地或事件地；不填就用小道起局的参考地点，返回里会写明）、daylightSaving、birthYearPillar（命主出生年的年柱干支，如「庚午」，用来看年命）、language		四柱、节气、阴阳遁和局数、旬首、值符、值使、伏吟反吟、五不遇时、空亡、驿马，九宫每一宫的星、门、神、天盘干、地盘干、寄干、暗干和门迫、击刑、入墓等标记；给了出生年柱的，再加年命落在哪一宫
true_solar_time
真太阳时换算		把出生地当时的钟表时间换成真太阳时必填：placeId、date、time
选填：calendar、isLeapMonth、daylightSaving、earlyLateZi、boundaryChoices、language		钟表时间、历史时区和偏移、当时是不是夏令时、真太阳时（精确到分）、子时口径。不回四柱和农历

用的时候要知道的

  • 时间填出生地当时的钟表时间。时区和夏令时按出生地当年的历史规定算，不按今天的。
  • 日期支持 1801 年到 2099 年，公历、农历都是；超出会回「输入有误」。
  • 真太阳时 = 钟表时间去掉夏令时，加经度修正（每度 4 分钟），再加均时差。
  • 子时默认 23 点换日，跟小道网站一样；八字想按零点换日，传 earlyLateZi: true。奇门固定 23 点换日，不能选。
  • 缺了信息，接口不会瞎猜，会请你补：钟表时间出现两次（秋天回拨）时，请选是不是夏令时；农历日期要说明是不是闰月；出生时间靠近时辰、换日或节气交界时，请选按当前时间（SAME）还是交界的另一边（OTHER）。春天跳过的那一小时不存在，不排。
  • 八字默认回「一生的骨架」加「出生地此刻」那一天；要别的日子，传 focusDate；要某几年的逐年详情，传 detailYears（一次最多 10 年）；要整个流月每一天，传 allDaysOfMonth。
  • 排盘文字是中文，干支、十神、神煞用这门学问通用的写法；同一份内容另有结构化数据。language 选 en 时，多一段英文的口径说明和行名对照。
  • 每次返回的开头有一段「口径」，写明这张盘按什么规则算的；末尾有几句给 AI 的话：这是排盘，不是断语，请按自己的学问解读并说清依据；不断死亡和寿数、不做医学诊断、不给投资借贷赌博的具体建议等。
  • 返回里附一个回小道的链接，只带来源标记，不带你的出生信息。

怎么问

下面的出生信息都是虚构的。

  • 「帮我排一个八字：男，1990 年 5 月 12 日早上 8 点 30 分，成都出生。」AI 助手会先查出生地，再排八字，把排好的盘讲给你。
  • 「用小道排一局奇门，现在，上海。」
  • 「1985 年 7 月 1 日凌晨 2 点 30 分，在纽约出生，真太阳时是几点？」
  • 「接着看我这张八字盘 2027 年 3 月 15 日那一天的流日。」

数据怎么处理

以下是《小道隐私政策》第二条第 9 项的要点，完整写法见隐私政策。

  • 使用不需要登录。小道不识别你的身份，不收集姓名或其他自由填写的内容，也不与任何账号关联。
  • 你的 AI 助手把排盘所需的信息发给小道：八字需要出生地、出生日期和时间、历法、性别和排盘选项；奇门需要起局那一刻的当地钟表时间，可以再给所在地或事件地、命主出生年的年柱干支；钟表时间出现两次时，还要选是不是夏令时。小道只用来排出这一次的盘，再把完整的排盘信息回给你的 AI 助手。
  • 这一次排盘只由程序完成，不调用小道推理引擎的算力提供方。这些信息和排出的盘不存进数据库，不写在硬盘上，不写进程序日志；每次请求处理完，结果就清空，不留存。
  • 跟网站其他部分一样，服务器访问日志会记 IP 地址（只保留前段）、请求的路径、状态码、耗时和浏览器标识；不记请求内容，你发送的信息不在里面。
  • 小道按 AI 助手自报的名称，把它归入几个类别，连同协议版本暂存在内存里，24 小时后过期；里面没有你发送的信息，自报的原名也不保留。
  • 你的 AI 助手怎么保存和使用你跟它的对话，由它的提供方的隐私政策管，不适用小道的政策。
  • 请求由位于新加坡的服务器处理。

隐私政策：《小道隐私政策》。联系方式：support@xiaodaox.com。

限制和出错

  • 接口里只有上面四个工具。小道网站上的八字报告、千问、今日运道等功能，不在接口里。
  • 所有人共用一个调用额度。用的人多的时候，会回「现在用的人太多，过会儿再试」，过一会儿再来就行。
  • 直接在浏览器页面里发请求的客户端，目前只放行 claude.ai 和 chatgpt.com 两个来源；别的这类客户端连不上的话，写信到 support@xiaodaox.com。桌面端、命令行这类不带来源的客户端不受影响。
  • 出错时，返回里会写原因：
    • 「输入有误，请检查出生地编号、日期、时间和选择项」：出生地编号要用 search_birth_place 查到的；日期写 YYYY-MM-DD，时间写 HH:MM；性别只能是 MALE 或 FEMALE。
    • 「focusDate 或 detailYears 超出起运前与十二步大运的覆盖范围」：换一个在这张盘大运范围内的日期或年份。
    • 「暂时无法完成换算或排盘，请稍后再试」：过一会儿再试。
    • 「需要补充……」：不是出错，是缺信息，按提示补上再调一次。
  • 用不通，或者想反馈：support@xiaodaox.com。