io.github.cyanheads

astronomy-mcp-server

Offline observational astronomy: positions, rise/set, moon phases, eclipses, and seasons.

communityknowledge

Package Details

Transportstdio
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:stdio

Environment Variables

MCP_LOG_LEVEL(str)
Default:info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

ASTRONOMY_ENABLE_HORIZONS(str)
Default:false

Register the astronomy_get_ephemeris tool, which fetches small-body and spacecraft ephemerides from JPL Horizons. Off by default; the core is keyless and offline.

ASTRONOMY_ENABLE_SATELLITES(str)
Default:false

Register the astronomy_get_satellite_passes tool, which predicts visible satellite passes from CelesTrak TLEs propagated with SGP4. Off by default.

ASTRONOMY_DEFAULT_TIMEZONE(str)

Fallback IANA timezone for observer-local output when a tool call omits `timezone`. Unset means UTC-only output.

TransportStreamable HTTP
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:http

Environment Variables

MCP_HTTP_HOST(str)
Default:127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORT(str)
Default:3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH(str)
Default:/mcp

The endpoint path for the MCP server.

MCP_AUTH_MODE(str)
Default:none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

MCP_LOG_LEVEL(str)
Default:info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

ASTRONOMY_ENABLE_HORIZONS(str)
Default:false

Register the astronomy_get_ephemeris tool, which fetches small-body and spacecraft ephemerides from JPL Horizons. Off by default; the core is keyless and offline.

ASTRONOMY_ENABLE_SATELLITES(str)
Default:false

Register the astronomy_get_satellite_passes tool, which predicts visible satellite passes from CelesTrak TLEs propagated with SGP4. Off by default.

ASTRONOMY_DEFAULT_TIMEZONE(str)

Fallback IANA timezone for observer-local output when a tool call omits `timezone`. Unset means UTC-only output.