Mcp Stargazing

by StarGazer1995

215 downloads
Not rated
GitHub

Description

# mcp-stargazing Calculate the altitude, rise, and set times of celestial objects (Sun, Moon, planets, stars, and deep-space objects) for any location on Earth. ## Features - **Altitude/Azimuth Calculation**: Get elevation and compass direction for any celestial object. -…

About

# mcp-stargazing Calculate the altitude, rise, and set times of celestial objects (Sun, Moon, planets, stars, and deep-space objects) for any location on Earth. ## Features - **Altitude/Azimuth Calculation**: Get elevation and compass direction for any celestial object. - **Rise/Set Times**: Determine when objects…

Details

Author
StarGazer1995
Downloads
215
Categories
Other

- Altitude/azimuth calculation for any celestial object
- Rise/set times with configurable horizon elevation
- Supports solar system objects, stars, and deep-space objects
- Time zone aware – works with local or UTC times
- Returns UTC times for rise and set events

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Stargazing
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with pip install astropy pytz numpy astroquery. Then use the functions celestial_pos and celestial_rise_set from the src.celestial module, passing an observer location (as an astropy.coordinates.EarthLocation), a timezone-aware datetime, and the celestial object name.

get_celestial_pos

Calculate the altitude and azimuth angles of a celestial object.

get_celestial_rise_set

Calculate the rise and set times of a celestial object.

get_moon_info

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

get_visible_planets

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

get_constellation

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

get_nightly_forecast

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

get_weather_by_name

Fetches weather data for a specified location by its name using the QWeather API.

get_weather_by_position

Fetches weather data for a specified location by its geographic coordinates (latitude and longitude) using the QWeather API.

light_pollution_map

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

analysis_area

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.

get_local_datetime_info

Retrieve the current datetime and timezone. Returns: Dict with keys "data", "_meta". "data" contains "current_time" (ISO string).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp stargazing": {
            "mcp-stargazing": {
                "isActive": true,
                "name": "mcp-stargazing",
                "command": "uvx",
                "args": [
                    "mcp-stargazing"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-stargazing": {
        "isActive": true,
        "name": "mcp-stargazing",
        "command": "uvx",
        "args": [
            "mcp-stargazing"
        ]
    }
}

mcp-stargazing

Calculate the altitude, rise, and set times of celestial objects (Sun, Moon, planets, stars, and deep-space objects) for any location on Earth.

Features

- Altitude/Azimuth Calculation: Get elevation and compass direction for any celestial object. - Rise/Set Times: Determine when objects appear/disappear above the horizon. - Supports: - Solar system objects (Sun, Moon, planets) - Stars (e.g., "sirius") - Deep-space objects (e.g., "andromeda", "orion_nebula") - Time Zone Aware: Works with local or UTC times.

Installation

pip install astropy pytz numpy astroquery

Usage

Calculate Altitude/Azimuth

```python src/main.py from src.celestial import celestial_pos from astropy.coordinates import EarthLocation import pytz from datetime import datetime
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.