Calculate the altitude and azimuth angles of a celestial object.

Args: celestial_object: Name of object (e.g. "sun", "moon", "andromeda") lon: Observer longitude in degrees lat: Observer latitude in degrees time: Observation time string "YYYY-MM-DD HH:MM:SS" time_zone: IANA timezone string

Returns: Dict with keys "data", "_meta". "data" contains "altitude" and "azimuth" (degrees).

Calculate the rise and set times of a celestial object.

Args: celestial_object: Name of object (e.g. "sun", "moon", "andromeda") lon: Observer longitude in degrees lat: Observer latitude in degrees time: Date string "YYYY-MM-DD HH:MM:SS" time_zone: IANA timezone string

Returns: Dict with keys "data", "_meta". "data" contains "rise_time" and "set_time".

Get detailed information about the Moon's phase and position.

When lat and lon are provided, also returns the Moon's local altitude and azimuth relative to the observer.

Args: time: Date string "YYYY-MM-DD HH:MM:SS" time_zone: IANA timezone string lat: Observer latitude in degrees (optional, for local position) lon: Observer longitude in degrees (optional, for local position)

Returns: Dict with keys "data", "_meta". "data" contains illumination, phase_name, age_days, elongation, earth_distance, and optionally altitude/azimuth.

Get a list of solar system planets currently visible (above horizon).

Args: lon: Observer longitude in degrees lat: Observer latitude in degrees time: Observation time string "YYYY-MM-DD HH:MM:SS" time_zone: IANA timezone string

Returns: Dict with keys "data", "_meta". "data" is a list of planet dicts (name, altitude, azimuth).

Get the position (altitude/azimuth) of the center of a constellation.

Args: constellation_name: Name of constellation (e.g. "Orion", "Ursa Major") lon: Observer longitude in degrees lat: Observer latitude in degrees time: Observation time string "YYYY-MM-DD HH:MM:SS" time_zone: IANA timezone string

Returns: Dict with keys "data", "_meta". "data" contains name, altitude, azimuth.

Get a curated list of best objects to view for the night.

Args: lon: Observer longitude in degrees lat: Observer latitude in degrees time: Date string "YYYY-MM-DD HH:MM:SS" (Time of observation, or just date) time_zone: IANA timezone string limit: Max number of deep-sky objects to return (default 20)

Returns: Dict with keys: - moon_phase: Moon details - planets: List of visible planets - deep_sky: Sorted list of deep sky objects (Messier/NGC)

Get metadata for all registered MCP tools.

Returns: Dict with keys "data", "_meta". "data" contains a list of tool metadata objects.

Get light pollution data for a specific area.

Returns a grid of light pollution data points including brightness, Bortle class, and SQM.

Args: south, west, north, east: Bounding box coordinates. zoom: Grid resolution zoom level (default: 10). Higher = more detailed.

Analyze a geographic area for suitable stargazing locations.

This tool searches for dark, accessible locations with good viewing conditions. Results are cached based on search parameters.

Fast mode: Set road_radius_km=0 to skip road connectivity checks. This avoids OSMnx network downloads from Overpass API and is much faster — use it when you only need candidate locations with light pollution and elevation data, without road distance analysis.

Args: south, west, north, east: Bounding box coordinates. max_locations: Maximum number of candidate locations to find (before pagination). min_height_diff: Minimum elevation difference for prominence. road_radius_km: Search radius for road access. Set to 0 to skip road checks. network_type: Type of road network ('drive', 'walk', etc.). db_config_path: Optional path to database config. page: Page number (1-based). page_size: Number of results per page.

Returns: Dict with keys "data", "_meta". "data" contains: - items: List of location results for the current page. - total: Total number of locations found. - page: Current page number. - page_size: Current page size. - resource_id: Cache key for the non-pagination search parameters.

通过地点名称获取综合天气（当前 + 小时预报 + 日预报）。

Geocoding uses Amap Geocoding API (CJK) → Photon → Nominatim cascade. Weather data is aggregated from multiple providers with graceful fallback — open-meteo is always available without an API key.

中文地名提示：建议使用完整行政区划名称，如 "浙江安吉"、"杭州西湖区"。 高德地理编码 API 会正确解析到对应的行政区（如安吉县），而非 POI 商铺。 需要精确定位时优先使用 get_weather_by_position(lat, lon)。

Args: place_name: 地点名称。中文请使用完整行政区划（如 "浙江省安吉县"），避免仅用2-3字短名。 provider: provider 模式，可选 all/qweather/open-meteo/wttr。

Returns: Dict，包含 keys: "data", "_meta"（成功时）或 "error", "_meta"（失败时）。

通过经纬度获取综合天气（当前 + 小时预报 + 日预报）。

Weather data is aggregated from multiple providers with graceful fallback — open-meteo is always available without an API key.

Args: lat: 纬度 lon: 经度 provider: provider 模式，可选 all/qweather/open-meteo/wttr。

Returns: Dict，包含 keys: "data", "_meta"（成功时）或 "error", "_meta"（失败时）。

Create a composite stargazing plan for a region and time.

This planning tool combines:

• candidate place search from analysis_area

• weather summaries from get_weather_by_position

• astronomy targets from get_nightly_forecast

Args: south, west, north, east: Bounding box coordinates. time: Observation time string in ISO format or YYYY-MM-DD HH:MM:SS. time_zone: IANA timezone string. candidate_limit: Maximum number of candidate places to evaluate. target_limit: Maximum number of recommended targets per place. weather_provider: Weather provider mode passed to weather tools. max_locations: Maximum number of area-analysis candidates to search. min_height_diff: Minimum elevation difference for prominence. road_radius_km: Search radius for road access. network_type: Type of road network to analyze. db_config_path: Optional path to database config.

Returns: Dict with keys data and _meta. data contains the normalized query, a plan summary, and ranked candidate recommendations.

Recommend astrophotography targets for a telescope setup.

Given a telescope/camera configuration and observing location+time, returns a ranked list of deep-sky objects best suited for imaging.

Args: focal_length_mm: Telescope focal length in mm (e.g. 250 for RedCat51) lon: Observer longitude in degrees lat: Observer latitude in degrees time: Observation time string "YYYY-MM-DD HH:MM:SS" time_zone: IANA timezone string (e.g. "Asia/Shanghai", "UTC") aperture_mm: Telescope aperture in mm (optional, for limiting magnitude) sensor_width_mm: Camera sensor width in mm (optional) sensor_height_mm: Camera sensor height in mm (optional) sensor_pixel_size_um: Camera pixel size in microns (optional) central_obstruction_pct: Central obstruction percentage (0-50) reducer_factor: Focal reducer factor (default 1.0) barlow_factor: Barlow/extender factor (default 1.0) mount_type: "equatorial" or "altaz" (default "equatorial") filter_type: Filter type — "Hα", "OIII", "SII", or None for LRGB limit: Maximum number of targets to return (default 20)

Returns: Dict with "data" containing a sorted list of telescope targets. Each target includes suitability_score, fov_fit_score, surface_brightness, filter_match_score, and mosaic_recommended.

Generate a single-night astrophotography shooting plan.

Runs match_telescope_targets then generate_shooting_schedule, returning targets + moon + timed shooting slots in one response.

Retrieve the current datetime and timezone.

Returns: Dict with keys "data", "_meta". "data" contains "current_time" (ISO string).