Celestial Node

Provides real-time space data tools from Celestial Node through a read-only MCP API.

javascript

0

GitHub Stars

javascript

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "christerso-celestialnode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "celestialnode-mcp"
      ],
      "env": {
        "CELESTIAL_NODE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You run a Celestial Node MCP server to access real-time space data tools in a lightweight, read-only environment. This MCP server provides 18 read-only endpoints for ISS/Tiangong tracking, crew in space, launches, space news, Mars missions, a large star catalog, near-Earth objects, satellites, and more, enabling AI assistants and clients to query space data efficiently.

How to use

Use an MCP client to connect to the Celestial Node MCP server and query its read-only tools. You can run the MCP locally or connect to a hosted endpoint if you have the URL. The server exposes real-time space information through simple, well-defined tools that you can invoke to retrieve positions, missions, news, and celestial data. Start by configuring your MCP client to point at the Celestial Node MCP server, then call the available tools to fetch the data you need.

How to install

Prerequisites: Node.js and npm must be installed on your system.

Ensure Node.js and npm are installed. You can verify with these commands:

node -v
npm -v

Install and run the MCP server using npx. This uses the Celestial Node MCP package to launch the server locally.

npx -y celestialnode-mcp

If you need to specify an API key for higher rate limits, set the API key environment variable when starting the MCP client. The key is optional for anonymous usage but required for higher quotas.

CELESTIAL_NODE_API_KEY=your-api-key-here npx -y celestialnode-mcp

Additional configuration and usage notes

The Celestial Node MCP server runs 18 read-only tools. You can tailor your client usage to request only the data you need, reducing latency and bandwidth.

Data sources and security

All data is served from celestialnode.com and aggregates information from NASA, ESA, CNSA, JAXA, Roscosmos, ISRO, SpaceX, and other space agencies. The tools are strictly read-only GET endpoints with no user data exposure.

Tools

The server offers 18 read-only tools for real-time space data.

Rate limits and access

Anonymous access is limited to 25 requests per hour. A registered API key grants higher limits, and paid plans offer even larger quotas.

Security

All 18 tools are read-only GET requests. There are no write operations or user data access.

License

MIT License

Available tools

get_iss_position

Real-time ISS position including latitude, longitude, altitude, and velocity.

get_tiangong_position

Real-time Tiangong space station position.

get_crew_in_space

List of astronauts, cosmonauts, and taikonauts currently in orbit.

get_upcoming_launches

Upcoming rocket launches from around the world.

get_space_news

Curated space news from major agencies.

get_mars_missions

All Mars missions with instruments and discoveries.

get_mars_rovers

Mars rovers with instruments, discoveries, and status.

get_mars_weather

Mars surface weather data including temperature, pressure, and wind.

search_stars

Search the ESA Gaia catalog of 1M+ stars.

get_star_details

Full astronomical data for a star by Gaia source ID.

get_constellations

All 88 IAU constellations.

get_near_earth_objects

Upcoming asteroid close approaches.

get_hazardous_asteroids

Potentially hazardous asteroids with orbital data.

get_space_agencies

Space agencies worldwide.

search_encyclopedia

Search the space encyclopedia for spacecraft, missions, and engines.

get_satellite_categories

Satellite categories with counts.

search_satellites

Search tracked satellites by name.

get_upcoming_reentries

Predicted satellite and rocket stage re-entries.