Celestialmcp

🚀 Astronomy MCP

A Model Context Protocol (MCP) server designed for Claude AI, used to calculate celestial positions, rising and setting times, and other astronomical data.

🚀 Quick Start

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

✨ Features

Overall Features

Astronomy MCP is built on the mcp - framework and uses the astronomy - engine library to achieve precise astronomical calculations. It offers various tools to determine the positions of celestial bodies, calculate their rising and setting times, and list available celestial bodies from star and deep - sky object catalogs.

Specific Functions

• Celestial Position Calculation: Obtain the elevation and azimuth coordinates of celestial bodies above a specified location on Earth.
• Rising/Setting Time Calculation: Find the times when a celestial body rises, transits the zenith, and sets from a specific location.
• Detailed Celestial Information: Provide comprehensive information about celestial bodies, including:
  • Distance (for solar system objects).
  • Phase information (for the Moon and planets).
  • Future lunar phases (for the Moon only).
• Rich Celestial Catalogs: Include:
  • Solar system objects (the Sun, the Moon, and planets).
  • Over 5,500 stars from the HYG database.
  • Over 14,000 deep - sky objects from the NGC catalog.

Tools

This package contains three main tools:

1. getCelestialPosition: Calculate the elevation and azimuth coordinates of celestial bodies.
2. getCelestialDetails: Provide detailed information about celestial bodies.
3. listCelestialObjects: Return a list of available celestial bodies categorized by type.

📦 Installation

Using with Claude Desktop

Local Development

Add the following content to your Claude Desktop configuration file:

Windows: %APPDATA%/Claude/claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Astronomy MCP": {
      "command": "node",
      "args":["/path/to/celstial-mcp/index.js"]
    }
  }
}

Download Star Chart Data

Run the following command to download and update the star catalog:

npm run fetch catalogs

📚 Documentation

Default Configuration

The project defaults the observer's location to Vancouver, with the following specific parameters:

• Latitude: 49.2827° N
• Longitude: 123.1207° W
• Altitude: 0 m
• Time Zone: America/Vancouver

Users can edit config.json to match their own location parameters.

Example Usage

Query Celestial Position

const response = await fetch('/api/celstial/position', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    celestialBody: 'Jupiter',
    date: new Date().toISOString()
  })
});

Get Celestial Information

const response = await fetch('/api/celstial/details', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    celestialBody: 'Moon'
  })
});

Project Structure

• src/
  • tools/: Core tools for astronomical calculations.
  • utils/: Auxiliary function modules.
  • config.js: Configuration management file.
  • index.js: Server entry program.
• scripts/: Contains data download and processing scripts.
• data/: Stores local catalog data.

⚠️ Important Note

1. Network Dependency: An internet connection is required for the first run to download the initial star chart data.
2. Performance Optimization: It is recommended to enable the caching mechanism for computationally intensive tasks.
3. Error Handling: It is recommended to configure comprehensive error capture and logging in a production environment.

For more detailed information, please refer to the official documentation.