This MCP server provides a Server-Sent Events (SSE) endpoint built with Quarkus that calculates the current moon phase or the phase for a given date. It exposes an MCP-compatible service over SSE, allowing clients to subscribe to moon phase updates and request specific dates to retrieve the corresponding lunar phase. The project is a Java Quarkus application, translated from a Moon Phase algorithm, and can be run via Maven during development or containerized for deployment. To use it, start the server in a Java-compatible environment (for example, via a Docker image as shown in the instructions) and connect to the MCP SSE endpoint to receive phase data; clients can query the current phase or specify a date to obtain the phase for that moment.

Prerequisites:

• Docker (for containerized setup) or Java Development Kit (JSR-310 based) and Maven Wrapper for local builds
• network access to fetch Maven dependencies

Installation steps:

1. Clone the repository (or pull the pre-built Docker image): git clone https://github.com/glaforge/moon-phases-quarkus-sse-server.git cd moon-phases-quarkus-sse-server

2. If installing locally (Java/Maven):

   • Ensure JDK 11+ is installed
   • Use the Maven wrapper to run in development mode: ./mvnw quarkus:dev

3. Packaging (produces a runnable jar): ./mvnw clean package

   Run the generated runnable jar

   java -jar target/quarkus-app/quarkus-run.jar

4. Native build (optional): ./mvnw clean package -Dnative

   Run the native executable

   ./target/moonphase-1.0-SNAPSHOT-runner

5. Containerized deployment (recommended for MCP SSE): Build or pull a suitable Docker image and run: docker run -i glaforge/moon-phases-quarkus-sse:latest

Note: The README suggests using Maven wrapper commands and provides guidance for packaging and running in both dev and native modes. If you plan to deploy to Cloud Run or another platform, containerization is the typical path.

Notes and tips:

• This server is an MCP SSE service implemented with Quarkus (Java).
• If using Docker, ensure the image tag corresponds to a build that includes the MCP SSE endpoints.
• For development, use the Maven wrapper commands provided in the README (./mvnw quarkus:dev) to enable live coding.
• When deploying to cloud environments, you can containerize the application and deploy the image to Cloud Run or Kubernetes as per the related article linked in the README.
• The project calculates moon phases using a translated algorithm from MoonPhase projects; ensure when querying dates to provide a valid ISO-8601 date (YYYY-MM-DD) if required by your MCP client.
• The README mentions a specific Cloud Run deployment workflow; adjust the container image name and project ID to your environment when following that guide.