Celestial Position MCP Server

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:

  1. getCelestialPosition: Calculates altitude/azimuth coordinates for a celestial object
  2. getCelestialDetails: Provides detailed information about a celestial object
  3. listCelestialObjects: Returns a list of available celestial objects by category

Quick Start

# Install dependencies npm install # Build the project npm run build # Start the server npm 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

{ "mcpServers": { "CelestialMCP": { "command": "node", "args":["/absolute/path/to/CelestialMCP/dist/index.js"] } } }

Catalog Data

This project includes a script to fetch astronomy catalog data:

# Fetch star and deep sky object catalogs npm run fetch-catalogs

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

CelestialMCP/ ├── src/ │ ├── tools/ # MCP Tools │ │ ├── CelestialPositionTool.ts │ │ ├── CelestialDetailsTool.ts │ │ └── ListCelestialObjectsTool.ts │ ├── utils/ │ │ └── astronomy.ts # Core astronomy calculations │ ├── config.ts # Observer configuration │ └── index.ts # Server entry point ├── scripts/ │ └── fetch-catalogs.js # Script to download star catalogs ├── data/ # Catalog data files │ ├── hygdata_v41.csv # HYG star database │ └── ngc.csv # New General Catalogue ├── package.json └── tsconfig.json

Default Configuration

By default, the observer's location is set to Vancouver, Canada. You can change this in src/config.ts:

export const OBSERVER_CONFIG = { latitude: 49.2827, // Observer latitude longitude: -123.1207, // Observer longitude altitude: 30, // Observer altitude in meters temperature: 15, // Default temperature in Celsius pressure: 1013.25 // Default pressure in hPa };

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.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

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.

  1. Overview
    1. Features
    2. Tools
  2. Quick Start
    1. Using with Claude Desktop
      1. Local Development
      2. Catalog Data
    2. Tool Usage
      1. Getting Object Position
      2. Getting Object Details
      3. Listing Available Objects
    3. Project Structure
      1. Default Configuration
        1. License
          1. Acknowledgements

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A 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 -
              24
              104
              23
              TypeScript
              ISC License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A 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 -
              47
              JavaScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              An 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
              • Apple
            • -
              security
              A
              license
              -
              quality
              Calculate the altitude, rise, and set times of celestial objects (Sun, Moon, planets, stars, and deep-space objects) for any location on Earth.
              Last updated -
              Python
              MIT License

            View all related MCP servers

            ID: 77u8rgvmfo