@openephemeris/mcp-server 3.2.13 → 3.3.0

package/dist/tools/specialized/venus_star_points.js

@@ -0,0 +1,187 @@
+import { registerTool, validateRequired } from "../index.js";
+import { backendClient } from "../../backend/client.js";
+function buildSubject(datetime, lat, lon) {
+    return {
+        name: "Subject",
+        birth_datetime: { iso: datetime },
+        birth_location: {
+            latitude: { decimal: lat },
+            longitude: { decimal: lon },
+        },
+    };
+}
+// POST /ephemeris/venus-star-points
+registerTool({
+    name: "venus_star_points",
+    description: "Get Venus Star Points — the Sun-Venus conjunction events nearest to a birth date. " +
+        "Shows the quality of each conjunction (cazimi, combust, under beams) with zodiac details.\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
+        "EXAMPLE: Venus star points for someone born 1990-04-15:\n" +
+        "  datetime='1990-04-15T14:30:00', latitude=41.88, longitude=-87.63",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: { type: "string", description: "Birth datetime (ISO 8601)." },
+            latitude: { type: "number", description: "Birth latitude." },
+            longitude: { type: "number", description: "Birth longitude." },
+            format: { type: "string", enum: ["json", "llm"], description: "Output format." },
+        },
+        required: ["datetime", "latitude", "longitude"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["datetime", "latitude", "longitude"]);
+        const query = {};
+        if (args.format)
+            query.format = args.format;
+        return await backendClient.request("POST", "/ephemeris/venus-star-points", {
+            data: { subject: buildSubject(args.datetime, args.latitude, args.longitude) },
+            params: query,
+        });
+    },
+});
+// POST /ephemeris/venus-star-points/conjunctions
+registerTool({
+    name: "venus_star_points_conjunctions",
+    description: "Find all Sun-Venus conjunctions in a date range. Returns each conjunction with " +
+        "its exact timestamp, zodiac position, orb, visibility (morning/evening star), and dignity.\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
+        "EXAMPLE: Find Venus conjunctions in 2026:\n" +
+        "  start_date='2026-01-01', end_date='2026-12-31'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            start_date: { type: "string", description: "Start date (ISO 8601)." },
+            end_date: { type: "string", description: "End date (ISO 8601)." },
+            format: { type: "string", enum: ["json", "llm"], description: "Output format." },
+        },
+        required: ["start_date", "end_date"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["start_date", "end_date"]);
+        const query = {};
+        if (args.format)
+            query.format = args.format;
+        return await backendClient.request("POST", "/ephemeris/venus-star-points/conjunctions", {
+            data: { start_date: args.start_date, end_date: args.end_date },
+            params: query,
+        });
+    },
+});
+// POST /ephemeris/venus-star-points/eight-year-star
+registerTool({
+    name: "venus_eight_year_star",
+    description: "Compute the 8-year Venus Star pattern — the pentagram of 5 Venus-Sun conjunctions " +
+        "that trace a near-perfect star over 8 years (the Venus synodic cycle). Returns the 5 " +
+        "vertices with their zodiac positions.\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
+        "EXAMPLE: 8-year star starting from 2020:\n" +
+        "  date='2020-01-01'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            date: { type: "string", description: "Start date for the 8-year cycle (ISO 8601)." },
+            format: { type: "string", enum: ["json", "llm"], description: "Output format." },
+        },
+        required: ["date"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["date"]);
+        const query = {};
+        if (args.format)
+            query.format = args.format;
+        return await backendClient.request("POST", "/ephemeris/venus-star-points/eight-year-star", {
+            data: { date: args.date },
+            params: query,
+        });
+    },
+});
+// POST /ephemeris/venus-star-points/phase
+registerTool({
+    name: "venus_phase",
+    description: "Get the current Venus phase — morning star, evening star, or combust. Returns Venus " +
+        "longitude, Sun longitude, elongation, retrograde/cazimi status.\n\n" +
+        "CREDIT COST: 1 credit per call.\n\n" +
+        "EXAMPLE: Venus phase right now:\n" +
+        "  date='2026-03-20'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            date: { type: "string", description: "Date to check (ISO 8601). Defaults to now." },
+            format: { type: "string", enum: ["json", "llm"], description: "Output format." },
+        },
+        required: ["date"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["date"]);
+        const query = {};
+        if (args.format)
+            query.format = args.format;
+        return await backendClient.request("POST", "/ephemeris/venus-star-points/phase", {
+            data: { date: args.date },
+            params: query,
+        });
+    },
+});
+// POST /ephemeris/venus-star-points/elongations
+registerTool({
+    name: "venus_elongations",
+    description: "Find Venus greatest elongation events (when Venus is farthest from the Sun in the sky). " +
+        "Returns east (evening star) and west (morning star) elongation peaks.\n\n" +
+        "CREDIT COST: 2 credits per call.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            start_date: { type: "string", description: "Start date (ISO 8601)." },
+            end_date: { type: "string", description: "End date (ISO 8601)." },
+            format: { type: "string", enum: ["json", "llm"], description: "Output format." },
+        },
+        required: ["start_date", "end_date"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["start_date", "end_date"]);
+        const query = {};
+        if (args.format)
+            query.format = args.format;
+        return await backendClient.request("POST", "/ephemeris/venus-star-points/elongations", {
+            data: { start_date: args.start_date, end_date: args.end_date },
+            params: query,
+        });
+    },
+});
+// POST /ephemeris/venus-star-points/stations
+registerTool({
+    name: "venus_stations",
+    description: "Find Venus retrograde and direct stations in a date range. Returns the exact " +
+        "moment Venus appears to stop and reverse direction.\n\n" +
+        "CREDIT COST: 2 credits per call.\n\n" +
+        "EXAMPLE: Venus stations in 2026:\n" +
+        "  start_date='2026-01-01', end_date='2026-12-31'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            start_date: { type: "string", description: "Start date (ISO 8601)." },
+            end_date: { type: "string", description: "End date (ISO 8601). Defaults to +1 year." },
+            format: { type: "string", enum: ["json", "llm"], description: "Output format." },
+        },
+        required: ["start_date"],
+        additionalProperties: false,
+    },
+    handler: async (args) => {
+        validateRequired(args, ["start_date"]);
+        const query = {};
+        if (args.format)
+            query.format = args.format;
+        return await backendClient.request("POST", "/ephemeris/venus-star-points/stations", {
+            data: {
+                start_date: args.start_date,
+                end_date: args.end_date || "",
+            },
+            params: query,
+        });
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.2.13",
+  "version": "3.3.0",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
     "dev": "tsx watch src/index.ts",
     "dev:sse": "tsx watch src/server-sse.ts",
     "start": "node dist/index.js",
-    "start:sse": "node dist/src/server-sse.js",
+    "start:sse": "node dist/server-sse.js",
     "test": "vitest run --exclude \"dist/**\"",
     "test:watch": "vitest --exclude \"dist/**\"",
     "test:integration": "tsx scripts/test-client.ts",