小 道生活 · 福澤

小道排盤接口（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。