Mcpiztro

🚀 紫微斗數 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的紫微斗數計算服務器。藉助強大的 iztro 庫，它能提供精確的紫微斗數排盤和運限分析功能，為用戶帶來便捷的運勢分析體驗。

🚀 快速開始

前置要求

• Node.js 18.0.0 或更高版本
• npm 包管理器

克隆倉庫

git clone https://github.com/wuunicorn/MCPIztro.git
cd MCPIztro

安裝依賴

npm install

配置

1. 創建配置文件

將 ziwei_mcp_config.json 中的路徑修改為您的實際項目路徑：

{
  "mcpServers": {
    "ziwei": {
      "command": "node",
      "args": ["/path/to/your/project/ziwei_mcp_server.js"],
      "env": {
        "NODE_PATH": "/path/to/your/project/node_modules"
      }
    }
  }
}

2. 在 MCP 客戶端中配置

將配置文件內容添加到您的 MCP 客戶端配置中（如 Claude Desktop、Cursor 等）。

啟動服務器

npm start
# 或
node ziwei_mcp_server.js

運行測試

npm test
# 或
node test_ziwei.js

✨ 主要特性

• 🌟 完整的紫微斗數排盤：支持陽曆和農曆生日計算，能為不同日期記錄方式的用戶提供服務。
• 📅 精確的時間處理：可獲取當前系統時間和詳細信息，為運勢分析提供準確的時間依據。
• 🔮 運限分析：提供大限、流年等運勢分析，幫助用戶瞭解不同階段的運勢情況。
• 🌐 多語言支持：支持簡體中文、繁體中文、英文、日文、韓文、越南文，滿足不同地區用戶的需求。
• 🔄 MCP 協議兼容：可與支持 MCP 的 AI 助手無縫集成，拓展了服務器的使用場景。
• ⚡ 輕量高效：基於 Node.js，響應快速，能及時為用戶提供分析結果。
• 📊 結構化數據：返回完整的 JSON 格式星盤數據，方便用戶進行數據處理和分析。

🛠️ 技術棧

💻 使用示例

在 MCP 客戶端中使用

配置完成後，您可以在支持 MCP 的客戶端中直接使用自然語言查詢：

請幫我排一個1990年8月16日下午2點出生的女性的紫微斗數星盤

我想看看這個人在2024年的運勢如何

直接 API 調用

# 獲取當前時間
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_current_time", "arguments": {}}}' | node ziwei_mcp_server.js

# 計算星盤
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "calculate_ziwei", "arguments": {"birthday": "1990-08-16", "hour": 14, "gender": "女"}}}' | node ziwei_mcp_server.js

📚 詳細文檔

API 文檔

服務器提供以下三個主要工具：

1. get_current_time

獲取當前系統時間的詳細信息。 參數：無 返回：

{
  "success": true,
  "data": {
    "year": 2024,
    "month": 8,
    "day": 1,
    "hour": 15,
    "minute": 30,
    "second": 45,
    "datetime_str": "2024-08-01 15:30:45",
    "weekday": "Thursday",
    "weekday_cn": "星期四",
    "timestamp": 1722513045
  }
}

2. calculate_ziwei

計算指定生辰的紫微斗數星盤。 參數：

• birthday (必需)：生日，格式 YYYY-MM-DD
• hour (可選)：出生時辰 (0 - 23)，默認 0
• gender (可選)：性別 ("男"/"女")，默認 "男"
• type (可選)：日期類型 ("solar"/"lunar")，默認 "solar"
• isLeapMonth (可選)：是否閏月，默認 false
• language (可選)：語言設置，默認 "zh-CN"

示例請求：

{
  "birthday": "1990-08-16",
  "hour": 14,
  "gender": "女",
  "type": "solar",
  "language": "zh-CN"
}

返回：完整的星盤數據，包含十二宮信息、星耀分佈、亮度等。

3. get_horoscope

獲取指定生辰在特定時間的運限信息。 參數：

• birthday (必需)：生日，格式 YYYY-MM-DD
• hour (可選)：出生時辰 (0 - 23)，默認 0
• gender (可選)：性別 ("男"/"女")，默認 "男"
• type (可選)：日期類型 ("solar"/"lunar")，默認 "solar"
• isLeapMonth (可選)：是否閏月，默認 false
• targetDate (可選)：目標日期，格式 YYYY-MM-DD，默認當前日期
• language (可選)：語言設置，默認 "zh-CN"

返回：運限信息，包含大限、流年、年齡等數據。

支持的語言

🏗️ 項目結構

MCPIztro/
├── README.md                 # 項目介紹文檔
├── package.json             # 項目配置和依賴
├── package-lock.json        # 依賴鎖定文件
├── ziwei_mcp_server.js      # MCP 服務器主程序
├── ziwei_mcp_config.json    # MCP 配置文件模板
├── test_ziwei.js           # 測試腳本
└── node_modules/           # 依賴包目錄

🔧 技術細節

開發

測試服務器功能

node test_ziwei.js

檢查語法

node -c ziwei_mcp_server.js

驗證依賴

node -e "import { astro } from 'iztro'; console.log('依賴加載成功');"

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

1. Fork 本倉庫
2. 創建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的修改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打開一個 Pull Request

📄 許可證

本項目採用 MIT 許可證 - 查看 LICENSE 文件瞭解詳情。

🙏 致謝

• iztro：提供強大的紫微斗數計算能力
• Model Context Protocol：提供標準化的協議支持

📞 聯繫

如果您有任何問題或建議，請通過以下方式聯繫：

• 提交 Issue
• 發送郵件到：wuunicorn@gmail.com

⚠️ 重要提示

紫微斗數僅供參考和娛樂，請理性對待運勢分析結果。