CelestialMCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para Claude AI que proporciona herramientas para calcular posiciones de objetos celestes, horas de salida y puesta y otros datos astronómicos.

Descripción general

CelestialMCP se basa en el marco mcp y utiliza la biblioteca astronomy-engine para proporcionar cálculos astronómicos precisos. Ofrece diversas herramientas para determinar la posición de los objetos celestes, calcular sus horas de salida y puesta, y listar los objetos disponibles en los catálogos de estrellas y objetos de cielo profundo.

Características

Cálculos de posición celeste : obtenga coordenadas de altitud y acimut de cualquier objeto celeste desde una ubicación específica en la Tierra
Cálculos de hora de salida y puesta : descubre cuándo salen, transitan y se ponen los objetos celestes desde una ubicación específica
Información detallada de objetos : obtenga información completa sobre los objetos celestes, incluidos:
- Distancia (para objetos del sistema solar)
- Información de fase (para la Luna y los planetas)
- Próximas fases lunares (para la Luna)
Amplio catálogo de objetos : Incluye:
- Objetos del sistema solar (Sol, Luna, planetas)
- Más de 5500 estrellas de la base de datos HYG
- Más de 14.000 objetos de cielo profundo del catálogo NGC

Herramientas

El paquete contiene tres herramientas principales:

getCelestialPosition : Calcula las coordenadas de altitud/azimut de un objeto celeste
getCelestialDetails : proporciona información detallada sobre un objeto celeste
listCelestialObjects : Devuelve una lista de objetos celestes disponibles por categoría

Inicio rápido

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Uso con Claude Desktop

Desarrollo local

Agregue esta configuración a su archivo de configuración de Claude Desktop:

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"]
    }
  }
}

Datos del catálogo

Este proyecto incluye un script para obtener datos del catálogo astronómico:

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

Esto descargará la base de datos de estrellas HYG y el catálogo de objetos de cielo profundo NGC al directorio data/ .

Uso de herramientas

A continuación se muestran algunos ejemplos del uso de las herramientas con Claude:

Obtener la posición del objeto

Pregúntale a Claude: "¿Cuál es la posición actual de Júpiter en el cielo desde Vancouver?"

Obtener detalles del objeto

Pregúntale a Claude: "¿Cuándo sale y se pone la Luna hoy en Vancouver?"

Listado de objetos disponibles

Pregúntale a Claude: "Muéstrame una lista de estrellas que pueda buscar".

Estructura del proyecto

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

Configuración predeterminada

De forma predeterminada, la ubicación del observador es Vancouver, Canadá. Puede cambiarla en 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
};

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

motor astronómico para cálculos astronómicos básicos
mcp-framework para la implementación del servidor MCP
Base de datos HYG para datos estelares
OpenNGC para datos de objetos del cielo profundo

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Proporciona coordenadas de altitud-azimut para objetos celestes, incluidos planetas, más de 117.000 estrellas y 14.000 objetos del cielo profundo según la hora del sistema y la ubicación configurable.

Related MCP Servers

Surf MCP Server
ravinahp
A
security
A
license
A
quality
Fetches tide information for any location using latitude and longitude, providing detailed tide data including high/low tides and station information with automatic UTC time zone handling.
Last updated -
1
14
MIT License
NASA MCP Service
liuwanglei-tal
-
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 -
0
2
MIT License
Astro Docs MCP Server
dreyfus92
A
security
F
license
A
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 -
1
3
mcp-stargazing
StarGazer1995
-
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 -
MIT License

View all related MCP servers

Celestial Position MCP Server