MCP Stargazing

🚀 MCP-觀星

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/

🔧 技術細節

本項目未來有以下規劃：

• 支持更多天體類型，以滿足更廣泛的天文觀測需求。
• 提高計算精度，使獲取的天體信息更加準確。
• 添加圖形化界面，提升用戶體驗。