Swiss Ephemeris

Swiss Ephemeris MCP サーバー

Swiss Ephemeris ライブラリを使用して天文計算を行う Model Context Protocol（MCP）サーバーです。任意の日付と場所について、惑星の位置、ハウス、チャートポイント、小惑星を計算できます。

機能

• 惑星の位置：太陽、月、水星、金星、火星、木星、土星、天王星、海王星、冥王星
• 月のノード：トゥルーノードとミーンノードの計算
• 小惑星：カイロン、ケレス、パラス、ジュノー、ベスタ、リリス
• ハウス：プラシーダス方式による12ハウスシステム
• チャートポイント：アセンダント、ミッドヘブン、IC、ディセンダント
• 追加ポイント：サウスノード、パート・オブ・フォーチュン

インストール

ローカル開発の前提条件

Claude Desktop でローカルに使用するには、Swiss Ephemeris の swetest コマンドをインストールする必要があります。

# Install swetest (required for Claude Desktop usage)
git clone https://github.com/aloistr/swisseph.git /tmp/swisseph && \
    cd /tmp/swisseph && \
    make && \
    cp swetest /usr/local/bin/ && \
    rm -rf /tmp/swisseph

Claude Desktop

Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "swissEphemeris": {
      "command": "npx",
      "args": ["github:dm0lz/swiss-ephemeris-mcp-server"]
    }
  }
}

手動インストール

git clone https://github.com/dm0lz/swiss-ephemeris-mcp-server.git
cd swiss-ephemeris-mcp-server
npm install
npm start

使用方法

サーバーは、次の4つの主要なツールを提供します。

calculate_planetary_positions

特定の日付、時刻、場所の天文データを計算します。

パラメーター：

• datetime（string）：ISO8601 形式。例："1985-04-12T23:20:50Z"
• latitude（number）：緯度（十進法の度数、-90～90）
• longitude（number）：経度（十進法の度数、-180～180）

戻り値：

• planets：すべての惑星と天体の位置
• houses：12の占星術ハウス
• chart_points：アセンダント、ミッドヘブン、IC、ディセンダント
• additional_points：サウスノード、パート・オブ・フォーチュン

calculate_transits

比較のために、出生図の位置と現在のトランジットを計算します。

パラメーター：

• birth_datetime（string）：出生日時（ISO8601 形式）
• latitude（number）：出生地の緯度（十進法の度数）
• longitude（number）：出生地の経度（十進法の度数）

戻り値：

• natal_chart：出生図の完全なデータ
• current_transits：現在の惑星の位置
• calculation_time：トランジット計算のタイムスタンプ

calculate_solar_revolution

特定の年のソーラーリターンチャートを計算します（太陽が出生時の位置に戻るとき）。

パラメーター：

• birth_datetime（string）：出生日時（ISO8601 形式）
• birth_latitude（number）：出生地の緯度（十進法の度数）
• birth_longitude（number）：出生地の経度（十進法の度数）
• return_year（number）：ソーラーリターンを計算する年（例：2024）
• return_latitude（number、optional）：ソーラーリターン地点の緯度
• return_longitude（number、optional）：ソーラーリターン地点の経度

戻り値：

• natal_chart：元の出生図データ
• solar_return_chart：指定した年のソーラーリターンチャート
• natal_sun_longitude：元の太陽の位置（度数）
• return_sun_longitude：ソーラーリターン時の太陽の位置（度数）
• calculation_time：計算のタイムスタンプ

calculate_synastry

2人の相性分析のために、シナストリーチャートを計算します。

パラメーター：

• person1_datetime（string）：1人目の出生日時（ISO8601 形式）
• person1_latitude（number）：1人目の出生地の緯度（十進法の度数）
• person1_longitude（number）：1人目の出生地の経度（十進法の度数）
• person2_datetime（string）：2人目の出生日時（ISO8601 形式）
• person2_latitude（number）：2人目の出生地の緯度（十進法の度数）
• person2_longitude（number）：2人目の出生地の経度（十進法の度数）

戻り値：

• person1_chart：1人目の出生図データ全体
• person2_chart：2人目の出生図データ全体
• synastry_aspects：2つのチャート間の惑星アスペクトの配列
• calculation_time：計算のタイムスタンプ

Docker

# Build and run
docker build -t swiss-ephemeris-mcp .
docker run -p 8000:8000 -e MCP_HTTP_MODE=true swiss-ephemeris-mcp

# Health check
curl http://localhost:8000/health

トランスポートモード

• Stdio：Claude Desktop 連携のデフォルトモード
• HTTP：ngrok 経由でウェブ連携するには MCP_HTTP_MODE=true を使用します

リンク

• MCP URL：https://www.theme-astral.me/mcp
• リポジトリ：https://github.com/dm0lz/swiss-ephemeris-mcp-server
• Swiss Ephemeris：https://www.astro.com/swisseph/

ライセンス

MIT