Mcpiztro

🚀 紫微斗数 MCP サーバー

このサーバーは Model Context Protocol (MCP) をベースにした紫微斗数計算サーバーです。強力な iztro ライブラリを使用して、正確な紫微斗数の排盤と運限分析機能を提供します。

🚀 クイックスタート

このサーバーを使用することで、様々な機能を利用して紫微斗数の計算や分析を行うことができます。以下に詳細な情報を提供します。

✨ 主な機能

• 🌟 完全な紫微斗数排盤 - 西暦と旧暦の誕生日計算に対応
• 📅 正確な時間処理 - 現在のシステム時間と詳細情報を取得
• 🔮 運限分析 - 大限、流年などの運勢分析
• 🌐 多言語対応 - 簡体字中国語、繁体字中国語、英語、日本語、韓国語、ベトナム語
• 🔄 MCP プロトコル互換 - MCP をサポートする AI アシスタントとシームレスに統合可能
• ⚡ 軽量で効率的 - Node.js をベースにしており、迅速な応答が可能
• 📊 構造化データ - 完全な JSON 形式の星盤データを返す

🔧 技術詳細

📦 インストール

前提条件

• 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 をサポートするクライアントで自然言語でクエリを行うことができます。
# 例: 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 ドキュメント

サーバーは以下の3つの主要なツールを提供します。

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

⚠️ 重要な注意

紫微斗数は参考や娯楽目的でのみ使用してください。運勢分析の結果は合理的に受け止めてください。