MCP Stargazing

🚀 MCP-観星

地球上の任意の位置における天体（太陽、月、惑星、恒星、深空天体）の高度角、昇降時間を計算し、オプションで光害分析もサポートします。

🚀 クイックスタート

MCP-観星は、地球上の任意の位置における天体の高度角、昇降時間を計算するツールです。また、光害分析もサポートしています。

✨ 主な機能

• 高度角/方位角計算：天体の仰角と方向を取得します。
• 昇降時間計算：天体が地平線上に現れ、消える時間を特定します。
• 光害分析：光害マップ（GeoTIFF形式）を読み込み、分析します。
• サポートされる天体の種類：
  • 太陽系天体（太陽、月、惑星）
  • 恒星（例：「sirius」）
  • 深空天体（例：「andromeda」、「orion_nebula」）
• タイムゾーン対応：現地時間またはUTC時間をサポートします。

📦 インストール

pip install astropy pytz numpy astroquery rasterio geopy

💻 使用例

基本的な使用法

高度角/方位角の計算

from src.celestial import celestial_pos
from astropy.coordinates import EarthLocation
import pytz
from datetime import datetime

# 観測者の位置（ニューヨーク）
location = EarthLocation(lat=40.7128, lon=-74.0060)

# 時間（タイムゾーン付きの現地時間）
local_time = pytz.timezone("America/New_York").localize(datetime(2023, 10, 1, 12, 0))
altitude, azimuth = celestial_pos("sun", location, local_time)
print(f"太陽の位置：高度角={altitude:.1f}°，方位角={azimuth:.1f}°")

昇降時間の計算

from src.celestial import celestial_rise_set

rise, set_ = celestial_rise_set("andromeda", location, local_time.date())
print(f"仙女座：昇る時間={rise.iso}，沈む時間={set_.iso}")

光害マップの読み込み

from src.light_pollution import load_map

# GeoTIFF形式の光害マップを読み込む
vriis_data, bounds, crs, transform = load_map("path/to/map.tif")
print(f"マップの境界：{bounds}")

📚 ドキュメント

API リファレンス

celestial_pos(celestial_object, observer_location, time) (src/celestial.py)

• 入力パラメータ：
  • celestial_object：天体の名前（例：「sun」、「andromeda」）。
  • observer_location：EarthLocationオブジェクト。
  • time：datetime（タイムゾーン付き）またはAstropyのTime。
• 戻り値：(高度角の度数, 方位角の度数)。

celestial_rise_set() (src/celestial.py)

• 入力パラメータ：
  • celestial_object：天体の名前。
  • observer_location：EarthLocationオブジェクト。
  • date：日付オブジェクト。
• 戻り値：(昇る時間, 沈む時間)。

テスト情報

デフォルトでは、すべてのテストが実行されます。テストを実行するには、以下のコマンドを実行してください。

pytest tests/

🔧 将来的な予定

• より多くの天体の種類をサポートする。
• 計算精度を向上させる。
• グラフィカルユーザーインターフェイスを追加する。