ephemeris-mcp

Ephemeris MCP 🌌

mcp-name: io.github.scottchronicity/ephemeris-mcp

AI エージェント向けの高精度な天文暦です。

Ephemeris MCP は、Swiss Ephemeris を使用して高精度な惑星位置を AI エージェントに提供する Model Context Protocol（MCP）サーバーです。

Claude Desktop で使用するには、次の内容を claude_desktop_config.json に追加します。

"mcpServers": {
  "ephemeris": {
    "command": "uvx",
    "args": ["ephemeris-mcp"]
  }
}

クイックスタート

PyPI 経由でインストール（推奨）

# Install with uvx (recommended - fast & isolated, no local install needed)
uvx ephemeris-mcp

# Or install globally with pip
pip install ephemeris-mcp
python -m ephemeris_mcp

MCP クライアントに登録する

MCP クライアントの設定に追加します（クライアントが必要に応じてサーバーを起動します）。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ephemeris-mcp": {
      "command": "uvx",
      "args": ["ephemeris-mcp"]
    }
  }
}

VS Code/Cursor/Windsurf（Cline MCP 設定）：

{
  "mcpServers": {
    "ephemeris-mcp": {
      "command": "uvx",
      "args": ["ephemeris-mcp"]
    }
  }
}

クライアントはサーバープロセスを自動的に起動し、stdin/stdout 経由で通信した後、処理が完了すると終了します。

別の方法：Docker

コンテナーによる分離を希望する場合：

# Pull latest image
docker pull ghcr.io/scottchronicity/ephemeris-mcp:latest

# Test it
docker run --rm -i ghcr.io/scottchronicity/ephemeris-mcp:latest

Docker を使用して MCP クライアントを設定します。

{
  "mcpServers": {
    "ephemeris-mcp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/scottchronicity/ephemeris-mcp:latest"]
    }
  }
}

ローカル開発

# Clone and install
git clone https://github.com/scottchronicity/ephemeris-mcp.git
cd ephemeris-mcp
uv sync

# Run tests
make test

# Run locally
uv run ephemeris-mcp

# Test the engine directly
make validate-happycase

利用可能なツール

get_planetary_positions

すべての惑星、太陽、月、チャートの角度について、トロピカル黄道帯の正確な位置を返します。

パラメーター：

• iso_time（string）：ISO-8601 タイムスタンプ（例："2025-12-16T15:28:00Z"）
• latitude（float）：観測者の緯度（デフォルト：42.3314 - ミシガン州デトロイト）
• longitude（float）：観測者の経度（デフォルト：-83.0458 - ミシガン州デトロイト）

戻り値：

• bodies：太陽、月、惑星の星座、度数、運動（順行／逆行）、速度、赤緯
• houses：星座と度数を含むアセンダント（ASC）とミッドヘブン（MC）

アーキテクチャ

アーキテクチャ上の決定については、docs/adr/ を参照してください。

• ADR 001：地心トロピカル黄道座標の仕様
• ADR 002：Conventional Commits によるセマンティックバージョニング
• ADR 003：CI/CD パイプラインのアーキテクチャ

ライセンス

AGPLv3