Integrations
Referenced as part of a configuration example showing how to combine with other MCP servers, specifically the Brave Search server which requires an API key.
Used as the runtime environment for the MCP server, allowing it to be started and run with the appropriate commands.
Used for package management and running scripts for the MCP server, including installation of dependencies and build processes.
CelestialMCP
A Model Context Protocol (MCP) server for Claude AI that provides tools for calculating celestial object positions, rise/set times, and other astronomical data.
Overview
CelestialMCP is built with the mcp-framework and leverages the astronomy-engine library to provide accurate astronomical calculations. It offers several tools for determining positions of celestial objects, calculating their rise and set times, and listing available objects from star and deep sky object catalogs.
Features
- Celestial Position Calculations: Get altitude and azimuth coordinates for any celestial object from a specified location on Earth
- Rise/Set Time Calculations: Find when celestial objects rise, transit, and set from a specific location
- Detailed Object Information: Get comprehensive information about celestial objects including:
- Distance (for solar system objects)
- Phase information (for Moon and planets)
- Upcoming lunar phases (for Moon)
- Extensive Object Catalog: Includes:
- Solar system objects (Sun, Moon, planets)
- 5,500+ stars from the HYG database
- 14,000+ deep sky objects from the NGC catalog
Tools
The package contains three main tools:
- getCelestialPosition: Calculates altitude/azimuth coordinates for a celestial object
- getCelestialDetails: Provides detailed information about a celestial object
- listCelestialObjects: Returns a list of available celestial objects by category
Quick Start
Using with Claude Desktop
Local Development
Add this configuration to your Claude Desktop config file:
Windows: %APPDATA%/Claude/claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Catalog Data
This project includes a script to fetch astronomy catalog data:
This will download the HYG star database and NGC deep sky object catalog to the data/
directory.
Tool Usage
Here are some examples of using the tools with Claude:
Getting Object Position
Ask Claude: "What is the current position of Jupiter in the sky from Vancouver?"
Getting Object Details
Ask Claude: "When does the Moon rise and set today in Vancouver?"
Listing Available Objects
Ask Claude: "Show me a list of stars I can look up."
Project Structure
Default Configuration
By default, the observer's location is set to Vancouver, Canada. You can change this in src/config.ts
:
License
MIT
Acknowledgements
- astronomy-engine for core astronomical calculations
- mcp-framework for the MCP server implementation
- HYG Database for star data
- OpenNGC for deep sky object data
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Provides altitude-azimuth coordinates for celestial objects including planets, over 117,000 stars, and 14,000 deep sky objects based on system time and configurable location.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides a standardized interface for AI models to interact with NASA's vast array of data sources including APOD, Mars Rover photos, satellite imagery, and space weather data.Last updated -2410423TypeScriptISC License
- -securityAlicense-qualityA feature-rich NASA data query tool that supports various NASA API services including astronomy pictures, Mars rover photos, Earth satellite images, near-Earth objects data, and space weather information through natural language queries.Last updated -47JavaScriptMIT License
- -securityFlicense-qualityAn MCP server that provides AI assistants with access to Astro documentation, enabling them to search and reference Astro docs when helping users with Astro-related tasks.Last updated -JavaScript
- -securityAlicense-qualityCalculate the altitude, rise, and set times of celestial objects (Sun, Moon, planets, stars, and deep-space objects) for any location on Earth.Last updated -PythonMIT License