getCelestialDetailsLABSCO SUMMARY
Tonight's sky, for where you are standing.
The star-hopping path is the part worth having: coordinates tell you where a faint object is, but the route from a bright star you can already identify is what gets it into the eyepiece.
What it is
An astronomy server built on the astronomy-engine library with local star and deep-sky catalogues. Calculations are made for a configured observer location and the current system time, covering solar system objects, stars from the HYG database, and Messier, NGC and IC objects.
What you get
- An object's position both ways - equatorial coordinates, and altitude and azimuth from where you are
- Whether it is up, and its rise, transit and set times
- Distance for solar system objects, illumination for the Moon and planets, and the coming lunar phases
- The catalogues browsed by category, so you can see what is available rather than guess at names
- A star-hopping path from a bright starting star to the target - the route through the eyepiece, not only the coordinates
Requirements
Node 18.19.0 or newer. Run the catalogue fetch after installing to pull the HYG star database and the OpenNGC deep sky catalogue - without it the server falls back to a much smaller built-in set. The observer location is configured in the project and defaults to Vancouver, Canada; change it before the rise and set times mean anything where you are.
Setup effort
Build from source — git clone https://github.com/Rkm1999/CelestialMCP
USE CASES
01
Deciding what is worth setting up for tonight
Read what the catalogues hold for the category you are after, then check which of those are actually up.
02
Planning around when something rises
Read the rise, transit and set times for the object, so the session starts at the right hour.
03
Finding a faint object through the eyepiece
Ask for the hop from a bright star you can already identify, rather than working from coordinates alone.
04
Checking whether the Moon will ruin it
Read the Moon's illumination and the phases coming up before committing to a deep-sky target.
3 tools
Listed in project docs. Your client may show a different list.
listCelestialObjectsgetStarHoppingPathBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
Node.js
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
Clone the repository (if you haven't already)
TERMINAL
git clone https://github.com/Rkm1999/CelestialMCP
cd CelestialMCPInstall dependencies
TERMINAL
npm installDownload Astronomical Catalogs
TERMINAL
npm run fetch-catalogsBuild the project
TERMINAL
npm run buildStart the server
TERMINAL
npm startMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"CelestialMCP": {
"command": "node",
"args": [
"<YOUR_PATH_TO_CELESTIAL_MCP>/project/dist/index.js"
]
}
}
}
