Brhiza/mingyu

mingyu は何をしますか？

八字、紫微、星盤、六爻、梅花、奇門、大六壬、小六壬、塔羅、雷諾曼、靈籤、擇日一站式排盤，輸出結構化提示詞與資料。提供公開 API、MCP Server 與 skill。

概述

此技能（Skill）提供了一個統一的排盤介面，支援多種東方與西方神秘學系統。無論你是開發者、AI代理使用者，還是玄學愛好者，都可以透過本技能快速獲取規範化的命理與占卜數據。

支援的排盤系統

• 八字（四柱八字）
• 紫微斗數
• 西洋占星（星盤）
• 六爻
• 梅花易數
• 奇門遁甲
• 大六壬
• 小六壬
• 塔羅牌
• 雷諾曼卡
• 靈籤（籤詩）
• 擇日（黃曆擇吉）

使用方法

作為 AI Agent 技能

將本技能的 Markdown 檔案（skill.md）放置於 AI 代理（如 Claude Code、Cursor 或 Codex）能讀取到的路徑，即可透過自然語言指令調用。

範例指令：

• “請幫我排一個八字，出生時間為1990年1月1日中午12點，地點台北。”
• “使用梅花易數占卜明日的財運，取卦為1、2、3。”
• “針對2024年6月15日，給出擇日建議。”

透過公開 API 直接調用

本服務同時提供公開的 RESTful API 端點，可直接透過 HTTP 請求獲取排盤數據。

API 基本路徑： https://api.brhiza.com/mingyu/v1

請求範例：

curl -X POST "https://api.brhiza.com/mingyu/v1/bazi" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "location": "Taipei",
    "gender": "male"
  }'

回應格式：

所有 API 回應皆為結構化的 JSON 物件，包含 status、data 與 structure 欄位。data 欄位包含原始的排盤結果，structure 欄位則提供人類可讀的結構化提示詞。

透過 MCP Server 整合

本技能亦可作為 MCP Server（Model Context Protocol）運行，讓支援 MCP 的客戶端（例如特定的 AI 工具或 IDE）直接動態載入功能。

啟動 MCP Server：

npx brhiza/mingyu-mcp-server

輸出結構化提示詞

每次排盤後，本技能會自動產生兩部分輸出：

1. 原始數據（Raw Data）：可供程式直接解析的 JSON 格式排盤結果。
2. 結構化提示詞（Structured Prompt）：以 Markdown 格式整理的人類可讀解釋與關鍵指示，適合直接輸入給其他 AI 模型進行進一步分析。

此設計讓開發者可以自由選擇直接使用資料，或是將結構化提示詞餵給大型語言模型（LLM）以獲得更多元化的解讀。

環境需求

• 若要執行本地的 MCP Server：Node.js 18 或以上版本。
• 若要作為 AI Agent 技能使用：無特殊需求，僅需支援 Markdown 技能載入的 AI 代理即可。

注意事項

• 所有占卜與命理結果僅供參考，不應作為決策的唯一依據。
• 使用 API 時，請遵守合理的速率限制（Rate Limit），避免過度請求。
• 本技能為開源專案，歡迎貢獻與反饋。

授權

MIT License