What is an MCP Server?

An MCP (Model Context Protocol) server acts as a bridge, allowing AI models to access and interact with external data sources and tools. It standardizes how applications provide context to LLMs (Large Language Models).

What does the Celestial Position MCP Server do?

It provides altitude-azimuth coordinates for celestial objects (stars, planets, etc.) using the current system time and a configured location. This enables AI models to “see” the sky.

What are the main features of the Celestial Position MCP Server?

Key features include:

• Getting altitude and azimuth coordinates
• Using system time or a specified time
• Configurable location
• Support for solar system objects, over 117,000 stars, and over 14,000 deep sky objects
• Raw coordinates without atmospheric refraction correction

How do I install the Celestial Position MCP Server?

1. Make sure you have Node.js and npm installed.
2. Clone the repository.
3. Run npm install.

How do I configure the server?

Update your location (latitude, longitude, altitude) in src/config.ts.

How do I start the server?

1. Build the project: npm run build
2. Start the server: npm start

How can I test the server?

Open test.html in your browser to access a simple interface for testing the server’s functionality.

What are the available tools/APIs?

• getCelestialPosition: Gets altitude and azimuth coordinates for a celestial object.
• listCelestialObjects: Lists available celestial objects by category.

How do I use this with Claude?

1. Start the server.
2. Enable developer mode in Claude Desktop.
3. Add your MCP server: http://localhost:3005/mcp
4. Ask Claude to get celestial positions.

Can Claude automatically start the Celestial Position MCP Server?

Yes, you can configure Claude to automatically start the server by adding the server configuration to your Claude MCP configuration.

Where can I find the astronomical catalog files?

The server uses astronomical catalogs from the /data directory. You can download them using npm run fetch-catalogs.

What is UBOS and how does it relate to the MCP Server?

UBOS is a full-stack AI Agent Development Platform that can orchestrate AI Agents, connect them with enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems. Integrating the Celestial Position MCP Server with UBOS allows you to build more complex and automated astronomical applications.

What kind of questions can I ask Claude after integrating this MCP server?

You can ask questions like:

• “Where is Jupiter in the sky right now?”
• “What’s the position of Sirius?”
• “Can I see M31 from my location tonight?”

What is the license for this project?

The project is licensed under the ISC license.