ERUX Astrology & Ephemeris Engine

ERUX 占星術・エフェメリス MCP サーバー

ERUX の公式 Model Context Protocol（MCP） サーバーです。高精度な天文エフェメリスと、二重黄道帯を用いた占星術インテリジェンスエンジンを提供します。

Claude Desktop、Cursor、Windsurf、Open-WebUI、LibreChat、または自律型エージェントフレームワークを直接接続し、C エフェメリスライブラリのコンパイルやローカルの Python バックグラウンドプロセスの実行なしに、決定論的な占星術計算を利用できます。

---

主な機能

• 高精度なエフェメリス計算：太陽、月、火星、水星、木星、金星、土星、ラーフ、ケートゥ、天王星、海王星、冥王星、キロンの惑星座標を1秒角未満の精度で算出します。
• ハイブリッド洞察モデル（二重黄道帯の分離）：西洋占星術のトロピカル方式・プラシーダス方式（心理的・気質的な特性）と、ヴェーダ占星術のサイデリアル方式・ラヒリ方式（カルマに基づく時期とダシャー期）を同時に評価します。
• 120年間のパラシャラ・ヴィムショッタリ・タイムライン：マハーダシャー、アンタルダシャー、プラティアンタルダシャーの多層階層を、正確な日付境界とともに時単位で提供します。
• リアルタイムのトランジット・ホロスコープ：出生図のカスプに対する惑星のトランジットを継続的に追跡し、構造化されたトランジット・アスペクト予測を提供します。
• トポセントリックな24時間ホラとムフールタ・エンジン：現地の日の出・日の入りに連動する動的な惑星時刻（ホラ）に加え、ラーフ・カーラ、ヤマガンダ、グリカ、アビジット・ムフールタを提供します。
• 古典的なヴェーダ占星術のヨーガ検出：惑星の発動要因の説明とともに、ラージャ、ダナ、パンチャ・マハープルシャ、ガジャ・ケサリのヨーガをアルゴリズムで特定します。
• インタラクティブなホイールの生成：ツールはインタラクティブなチャートホイールの URL（https://erux.ai/chart?id=...）と、レンダリング済みの PNG プレビューを自動的に返します。

---

オムニチャネルボットのエコシステムとコミュニティ

ERUXは、MCP サーバー、ウェブアプリケーション、チャット連携の間で、コマンドを1対1で完全に対応させています。

プラットフォーム	チャネル／アクセス方法	機能
MCP Server	https://api.erux.ai/mcp	Claude、Cursor、Windsurf、Open-WebUI、AI エージェントとの直接連携
Smithery	Smitheryで表示	ワンクリックのCLIインストーラー（npx -y @smithery/cli run @akash-agl92/erux_mcp --client claude）
MCPRush	MCPRushで表示	クライアントの直接設定機能を備えた、厳選されたグローバルMCPディレクトリへの掲載
Discord Bot	Discordサーバーに追加	インタラクティブなスラッシュコマンド：/chart、/horoscope、/dasha、/yogas、/ask
Discord Community	コミュニティに参加	占星術師コミュニティでの議論、リリース情報、開発者サポート
ChatGPT	OpenAI Plugin（審査中）	占星術チャートの直接的な対話型統合、ヴィムショッタリ・ダシャー、トランジット
WhatsApp	WhatsAppでチャット	ネイタルチャートの即時表示、毎日のホーラー・スケジュール、トランジットに関する対話型Q&A
Instagram	@eruxaistro	ダイレクトメッセージによる占星術相談、トランジット通知、視覚的なチャートカード
Messenger	m.me/eruxai	Facebook Messengerのオムニチャネルボット。すべての主要なエフェメリスツールに1対1で対応
Web Platform	erux.ai	ビジュアルなインタラクティブチャート、複数のヴァルガ分割図（D1～D60）、トランジット

---

クイックスタート：MCPクライアントへの追加

ERUXはリモートのStreamable HTTP（SSE）サーバーとして動作します。ローカルパッケージのインストール、pip install、npxによるコンパイルは必要ありません。

1. Claude Desktop

claude_desktop_config.jsonに次の内容を追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

mcp-remoteを使用する場合（オプションのstdioブリッジ）： クライアントでstdioプロセスが必須の場合：

{
  "mcpServers": {
    "erux-astrology": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.erux.ai/mcp"]
    }
  }
}

---

2. Cursor IDE

.cursor/mcp.jsonに追加します（または、Cursorの「Settings」>「Features」>「MCP」から追加します）。

{
  "mcpServers": {
    "erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

---

3. Windsurf（Codeium）

mcp_config.jsonに追加します。

{
  "mcpServers": {
    "erux-astrology": {
      "serverUrl": "https://api.erux.ai/mcp"
    }
  }
}

---

4. Open-WebUIとLibreChat

Admin Panel > Settings > Tools / MCPに移動し、リモートSSEエンドポイントを登録します。

• Server Name：erux-astrology
• Server URL：https://api.erux.ai/mcp
• Transport：sse / streamable-http

---

5. Smithery CLI（自動ワンクリックインストール）

Smitheryを使用して、ERUXをClaude Desktopに自動設定し、接続するには：

npx -y @smithery/cli run @akash-agl92/erux_mcp --client claude

---

6. Python／LangChain／CrewAIエージェント

from mcp import ClientSession
from mcp.client.sse import sse_client

async def run_astrology_agent():
    async with sse_client("https://api.erux.ai/mcp") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # List available tools
            tools = await session.list_tools()
            print([tool.name for tool in tools.tools])
            
            # Calculate birth chart
            result = await session.call_tool("calculate_chart", {
                "date": "1992-10-14",
                "time": "14:30",
                "city": "Austin, Texas",
                "system": "hybrid"
            })
            print(result)

---

ツール一覧

ERUXは、ホストモデルに6つの決定論的なツールを提供します。

1. calculate_chart

個人の出生図または国のマンデンチャートを計算します。

• 引数：
  • date（string、YYYY-MM-DD）：生年月日または国の建国日。
  • time（string、HH:MM）：24時間表記の出生時刻（不明な場合は正午の12:00が既定値です）。
  • city（string）：出生地または建国地の都市。
  • country（optional string）：都市名を特定するための国。
  • system（optional string）：'hybrid'（既定値）、'vedic'、または'western'。
• 出力：正確な惑星黄経、逆行、ナクシャトラ、ハウスカスプ、現在のダシャー周期、インタラクティブなchart_ui_url。

2. get_horoscope

トランジット占星術、毎日の24ホラの惑星時刻、トランジットアスペクトの予測を生成します。

• 引数：
  • birth_date（string、YYYY-MM-DD）：ユーザーの出生年月日。
  • birth_city（string）：出生地の都市。
  • birth_time（optional string、デフォルトは'12:00'）：出生時刻。
  • current_city（optional string）：現地の地平線をトポセントリック方式で計算するための、転居先の都市。
  • cadence（optional string）：'daily'（ホラとパンチャンガム）、'weekly'、'monthly'、'yearly'（ソーラーリターン）。
  • target_date（optional string）：未来の予測対象日。
• 出力：現実に即した戦略的ガイダンス、トポセントリック方式による24ホラのスケジュール、ラーフ・カーラ、トランジット予測、インタラクティブなトランジットホイールへのリンク。

3. calculate_dasha

120年にわたるパラーシャラ式ヴィムショッタリーの惑星タイムラインを計算します。

• 引数：
  • date（string、YYYY-MM-DD）：出生年月日。
  • time（string、HH:MM）：24時間表記の出生時刻。
  • city（string）：出生地の都市。
  • target_date（optional string）：有効なサブ期間を確認する対象日。
• 出力：120年間のマハーダシャーのタイムラインと、すべてのアンタルダシャーおよびプラティアンタルダシャーの開始日と終了日。

4. get_yogas

古典的なヴェーダ占星術のヨーガと、現在有効な惑星配置を特定します。

• 引数：
  • date（string、YYYY-MM-DD）：出生年月日。
  • time（string、HH:MM）：24時間表記の出生時刻。
  • city（string）：出生地の都市。
• 出力：検出されたヨーガ（ラージャ、ダナ、ガジャケーサリ、マハープルシャ）、強さの評価、惑星のトリガー。

5. ask_astrology_guidance

ハウスの象意とカーラカに基づき、人生の主要な領域を文脈に沿って統合的に分析します。

• 引数：
  • prompt（string）：人生に関する質問（例：キャリアの転換、転居のタイミング）。
  • birth_date（string）：出生年月日。
  • birth_city（string）：出生地の都市。
• 出力：関連するハウスとカーラカの分析に基づく、根拠のある占星術の枠組みに沿ったガイダンス。

6. get_interpretation

人生の主要な領域について、包括的かつ詳細な分析を行います。

• 引数：
  • pillar（string）：'career'、'love'、'wealth'、'health'、または'spirituality'。
  • date（string）：出生年月日。
  • city（string）：出生地の都市。
• 出力：出生時の惑星配置、ダシャー周期、トランジットの影響を組み合わせた詳細な分析。

---

プロンプトの例

MCP に接続されたモデルに質問します：

• 「現在のヴィムショッタリー・マハーダシャーとアンタルダシャーを教えてください。1992年10月14日午後2時30分に、テキサス州オースティンで生まれました。」
• 「出生図の全体をホイールで表示し、ヴェーダ占星術のヨーガを計算してください。」
• 「今日、ロンドンでの商談に最適な天文学上のホラはいつですか？」
• 「フランスのマンデーン占星術の出生図を計算し、主な惑星配置を要約してください。」
• 「来月、キャリアの転換を計画しています。出生時の惑星配置に基づくと、現在どの惑星トランジットが起きていますか？」

---

セキュリティとアーキテクチャ

• ホスト型リモートエンドポイント：すべての天文計算は、安全性を強化したERUXのクラウドインフラストラクチャ（api.erux.ai）上で実行されます。
• ローカルでのコード実行なし：ERUXに接続しても、ローカルマシン上で任意のバイナリやスクリプトが実行されることはありません。
• APIキー不要：公開MCPエンドポイントでは、標準的なクエリに認証や事前のAPIキーは必要ありません。
• 読み取り専用かつ冪等：すべてのツールは読み取り専用かつ冪等として注釈されており、エンタープライズのエージェントワークフロー内で安全に実行できます。

---

リソースとリンク

• ウェブアプリケーション：https://erux.ai
• 開発者向けMCPドキュメント：https://erux.ai/developers/mcp
• Discordボット：ボットを招待
• コミュニティDiscord：コミュニティに参加
• 公式MCPレジストリ：レジストリへのリンク

---

ライセンス

このリポジトリとその設定スキーマは、MIT License の下でライセンスされています。 ERUX API を通じて提供される計算結果とデータには、ERUX Terms of Service が適用されます。