@openephemeris/mcp-server 3.9.1 → 3.9.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -4
- package/dist/index.js +1 -1
- package/dist/server-sse.js +7 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
[](https://www.npmjs.com/package/@openephemeris/mcp-server)
|
|
5
5
|
[](https://status.openephemeris.com/)
|
|
6
6
|
|
|
7
|
-
Model Context Protocol server for OpenEphemeris —
|
|
7
|
+
Model Context Protocol server for OpenEphemeris — 52 typed astrology tools powered by the NASA JPL DE440 ephemeris. Zero hallucination on planetary positions, dates, and degrees. Covers 1,100 years of astronomical data.
|
|
8
8
|
|
|
9
9
|
**Hosted endpoint:** `https://mcp.openephemeris.com/mcp` (Streamable HTTP, MCP 2025-11-25 spec)
|
|
10
10
|
|
|
@@ -302,7 +302,7 @@ npm run verify:release
|
|
|
302
302
|
|
|
303
303
|
### Deploying the SSE Server to Fly.io
|
|
304
304
|
|
|
305
|
-
When you update the MCP server logic (handlers, bug fixes, hardening), you should deploy it so clients connecting via
|
|
305
|
+
When you update the MCP server logic (handlers, bug fixes, hardening), you should deploy it so clients connecting via the remote `https://mcp.openephemeris.com/mcp` endpoint get the updates immediately.
|
|
306
306
|
|
|
307
307
|
1. Navigate to `apps/api/mcp-server`
|
|
308
308
|
2. Run `fly deploy --remote-only`
|
|
@@ -343,7 +343,8 @@ When you update the MCP server logic (handlers, bug fixes, hardening), you shoul
|
|
|
343
343
|
┌────────────────────────┐
|
|
344
344
|
│ OpenEphemeris API │
|
|
345
345
|
│ api.openephemeris.com │
|
|
346
|
-
│ JPL DE440
|
|
346
|
+
│ NASA JPL DE440 │
|
|
347
|
+
│ 1,100 years of data │
|
|
347
348
|
└────────────────────────┘
|
|
348
349
|
```
|
|
349
350
|
|
|
@@ -375,6 +376,6 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
|
|
|
375
376
|
Most LLMs (like Claude and ChatGPT) struggle heavily with astronomical calculations (trigonometry, Julian date conversions, and planetary lookups). OpenEphemeris serves as a **secure, remote math engine**.
|
|
376
377
|
|
|
377
378
|
By pairing LLMs with the OpenEphemeris MCP server, your agents can instantly access:
|
|
378
|
-
- **Zero-hallucination coordinates**: Direct, sub-arcsecond NASA JPL DE440
|
|
379
|
+
- **Zero-hallucination coordinates**: Direct, sub-arcsecond NASA JPL DE440 calculations spanning 1,100 years of astronomical data.
|
|
379
380
|
- **LLM-optimized tokens (`format=llm`)**: We compress standard 25,000 token JSON chart responses into minimal text blocks, cutting your inference costs by 50%.
|
|
380
381
|
- **Ready-to-use astrology layers**: Built-in support for Astrocartography geoJSON lines, Hermetic Lots, Fixed Stars, and complex Human Design matrix generation.
|
package/dist/index.js
CHANGED
|
@@ -75,7 +75,7 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
|
|
|
75
75
|
content: {
|
|
76
76
|
type: "text",
|
|
77
77
|
text: "Welcome to the **Open Ephemeris MCP Server**!\n\n" +
|
|
78
|
-
"You are now connected to an enterprise-grade astrological and astronomical computation engine powered by NASA JPL DE440
|
|
78
|
+
"You are now connected to an enterprise-grade astrological and astronomical computation engine powered by NASA JPL DE440 ephemeris data (1550–2650 CE). As a generative guide, here is how you can best utilize these tools to help the user:\n\n" +
|
|
79
79
|
"### Core Capabilities\n" +
|
|
80
80
|
"- **Birth Charts:** Use `ephemeris_natal_chart` for full planetary positions, houses, dignities, and aspects.\n" +
|
|
81
81
|
"- **Predictive Timing:** `ephemeris_transits` searches for exact dates when transiting planets hit natal points.\n" +
|
package/dist/server-sse.js
CHANGED
|
@@ -154,7 +154,7 @@ const WELCOME_PROMPT_CONTENT = [
|
|
|
154
154
|
"• **Chart Wheels** — visual PNG/SVG wheels and bi-wheels\n" +
|
|
155
155
|
"• **Time Lords** — Firdaria, Profections, Zodiacal Releasing\n\n" +
|
|
156
156
|
"**Tips:** Use `format=\"llm\"` on any tool to get ~50% smaller, token-optimized output. " +
|
|
157
|
-
"All computations are sub-arcsecond precision using JPL DE440
|
|
157
|
+
"All computations are sub-arcsecond precision using JPL DE440 ephemerides.\n\n" +
|
|
158
158
|
"Just tell me what you'd like to explore!",
|
|
159
159
|
},
|
|
160
160
|
},
|
|
@@ -177,17 +177,17 @@ function createMcpServer() {
|
|
|
177
177
|
// description is in the MCP spec (spec.types.d.ts Implementation interface)
|
|
178
178
|
// but the SDK's Zod schema doesn't include it yet — pass via spread
|
|
179
179
|
...{
|
|
180
|
-
description: "NASA JPL-backed astronomical computation engine for AI agents. " +
|
|
181
|
-
"
|
|
180
|
+
description: "NASA JPL DE440-backed astronomical computation engine for AI agents. " +
|
|
181
|
+
"52+ typed tools covering natal charts, transit forecasting, Human Design " +
|
|
182
182
|
"bodygraphs, eclipses, astrocartography power lines, Venus Star Points, " +
|
|
183
183
|
"electional timing, synastry, composite charts, Vedic/Jyotish, Chinese BaZi, " +
|
|
184
|
-
"and more — powered by JPL DE440
|
|
184
|
+
"and more — powered by JPL DE440 ephemerides for sub-arcsecond accuracy.",
|
|
185
185
|
},
|
|
186
186
|
}, {
|
|
187
187
|
capabilities: { tools: {}, prompts: {} },
|
|
188
188
|
instructions: "Open Ephemeris is a precision astronomical computation engine. " +
|
|
189
189
|
"Use format='llm' on any tool for compact, token-efficient output. " +
|
|
190
|
-
"All computations use JPL DE440
|
|
190
|
+
"All computations use JPL DE440 ephemerides for sub-arcsecond accuracy. " +
|
|
191
191
|
"See the 'welcome_to_open_ephemeris' prompt for a full capability overview.",
|
|
192
192
|
});
|
|
193
193
|
// --- Tool handlers ---
|
|
@@ -290,10 +290,10 @@ async function main() {
|
|
|
290
290
|
serverInfo: {
|
|
291
291
|
name: "Open Ephemeris",
|
|
292
292
|
version,
|
|
293
|
-
description: "NASA JPL-backed astronomical computation engine for AI agents.
|
|
293
|
+
description: "NASA JPL DE440-backed astronomical computation engine for AI agents. 52+ typed tools covering " +
|
|
294
294
|
"natal charts, transit forecasting, Human Design bodygraphs, eclipses, astrocartography " +
|
|
295
295
|
"power lines, Venus Star Points, electional timing, synastry, composite charts, Vedic/Jyotish, " +
|
|
296
|
-
"Chinese BaZi, and more — powered by JPL DE440
|
|
296
|
+
"Chinese BaZi, and more — powered by JPL DE440 ephemerides for sub-arcsecond " +
|
|
297
297
|
"zero-hallucination accuracy. Free Explorer tier available.",
|
|
298
298
|
iconUrl: "https://mcp.openephemeris.com/icon.png",
|
|
299
299
|
homepage: "https://openephemeris.com",
|