astronomy-oracle

Astronomy Oracle

LLM アシスタント向けの、精度の高い天体カタログデータと観測セッション計画ツールです。等級、座標、観測可能性の幻覚を防ぎます。

機能

• 天体の検索、カタログ検索、観測セッション計画のための3 つのツール
• OpenNGC カタログに収録された13,000 個以上の深宇宙天体（NGC、IC、メシエ天体、および追加天体）
• 決定論的な天文学計算 — ユリウス日、恒星時、地平座標への変換、出没・南中時刻
• ネットワーク依存なし — すべてのデータが同梱され、すべての計算がローカルで実行されます

インストール

npx で直接実行します：

npx astronomy-oracle

または、グローバルにインストールします：

npm install -g astronomy-oracle

設定

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "astronomy-oracle": {
      "command": "npx",
      "args": ["-y", "astronomy-oracle"]
    }
  }
}

Claude Code

claude mcp add astronomy-oracle -- npx -y astronomy-oracle

ツールリファレンス

lookup_object

メシエ番号、NGC/IC 指定、または一般名で天体を検索します。任意で、指定した場所と時刻から観測可能性を計算できます。

{
  "name": "lookup_object",
  "arguments": {
    "name": "M31",
    "latitude": 51.5,
    "longitude": -0.1,
    "date": "2025-06-15T22:00:00Z"
  }
}

天体の種類、座標（赤経／赤緯）、等級、視直径、表面輝度、ハッブル分類、相互参照などの詳細データを返します（場所を指定した場合は、現在の高度／方位角と出没・南中時刻も返します）。

search_objects

種類、星座、等級範囲、視直径、またはカタログへの収録状況でカタログを検索し、絞り込みます。

{
  "name": "search_objects",
  "arguments": {
    "type": "PN",
    "constellation": "Lyr",
    "maxMagnitude": 12.0,
    "limit": 10
  }
}

一致する天体を明るさ順に並べた表を返します。天体の種類（銀河、惑星状星雲、散開星団など）、星座、等級範囲、最小視直径、カタログ（メシエ、カルドウェル、NGC、IC）で絞り込めます。

plan_session

指定した場所と日付の観測セッション計画を作成します。観測に最適な天体を時間帯別にまとめて返します。

{
  "name": "plan_session",
  "arguments": {
    "latitude": 40.7,
    "longitude": -74.0,
    "date": "2025-03-20",
    "minAltitude": 20,
    "maxMagnitude": 10.0,
    "types": ["G", "PN", "GCl"]
  }
}

観測可能性を高度、等級、視直径に基づいて評価し、天体を3 つの時間帯（夕方、深夜、夜明け前）に分けて返します。

データソース

ソース	ライセンス	説明
OpenNGC	CC-BY-SA 4.0	座標、等級、サイズ、相互参照を含む NGC/IC/メシエカタログ

OpenNGC のデータは、Creative Commons Attribution-ShareAlike 4.0 International License に基づいて収録されています。詳細な帰属表示については、OpenNGC リポジトリをご覧ください。

開発

# Run tests
npm test

# Build
npm run build

# Run in development mode (tsx)
npm run dev

# Open MCP Inspector
npm run inspect

ライセンス

コードは MIT ライセンス、OpenNGC データは CC-BY-SA 4.0 ライセンスです。