@openephemeris/mcp-server 3.2.0 → 3.2.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.
Files changed (25) hide show
  1. package/README.md +22 -2
  2. package/config/dev-allowlist.json +1262 -1318
  3. package/dist/scripts/test-client.d.ts +1 -0
  4. package/dist/scripts/test-client.js +69 -0
  5. package/dist/scripts/test-sse-client.d.ts +1 -0
  6. package/dist/scripts/test-sse-client.js +221 -0
  7. package/dist/src/auth/device-auth.js +3 -0
  8. package/dist/src/index.js +6 -0
  9. package/dist/src/server-sse.d.ts +1 -0
  10. package/dist/src/server-sse.js +264 -0
  11. package/dist/src/tools/auth.js +6 -6
  12. package/dist/src/tools/dev.js +26 -18
  13. package/dist/src/tools/index.d.ts +8 -0
  14. package/dist/src/tools/index.js +23 -0
  15. package/dist/src/tools/specialized/eclipse.js +11 -14
  16. package/dist/src/tools/specialized/electional.js +3 -2
  17. package/dist/src/tools/specialized/human_design.js +4 -3
  18. package/dist/src/tools/specialized/moon.js +3 -2
  19. package/dist/src/tools/specialized/natal.js +22 -13
  20. package/dist/src/tools/specialized/relocation.js +14 -9
  21. package/dist/src/tools/specialized/synastry.js +23 -11
  22. package/dist/src/tools/specialized/transits.js +20 -13
  23. package/dist/test/allowlist-and-tools.test.js +13 -13
  24. package/dist/test/backend-client.test.js +1 -3
  25. package/package.json +7 -1
package/README.md CHANGED
@@ -125,6 +125,10 @@ This package runs as a local stdio MCP server. Remote-only clients require a hos
125
125
 
126
126
  Legacy aliases (`ASTROMCP_*`, `MERIDIAN_*`) remain supported.
127
127
 
128
+ ## Legal
129
+
130
+ This package is licensed under the [MIT License](./LICENSE). However, use of this package to access the OpenEphemeris API constitutes use of the Service and is governed by the [OpenEphemeris Terms of Service](https://openephemeris.com/terms). By using this package, you agree to those terms. See also the [Privacy Policy](https://openephemeris.com/privacy) and [Acceptable Use Policy](https://openephemeris.com/acceptable-use).
131
+
128
132
  ## Development
129
133
 
130
134
  ```bash
@@ -139,6 +143,15 @@ npm run check:readme
139
143
  npm run verify:release
140
144
  ```
141
145
 
146
+ ### Deploying the SSE Server to Fly.io
147
+
148
+ When you update the MCP server logic (handlers, bug fixes, hardening), you should deploy it so clients connecting via our remote `https://mcp.openephemeris.com/sse` endpoint get the updates immediately.
149
+
150
+ 1. Navigate to `apps/api/mcp-server`
151
+ 2. Run `fly deploy --remote-only`
152
+
153
+ *Note on NPM:* Deploying to Fly.io instantly updates the web-accessible SSE tool. However, users installing your tool locally in Cursor/Desktop via `npx @openephemeris/mcp-server` will *only* receive the updates once a new version is published to NPM. If your changes are critical, you should bump the version in `package.json` and run `npm publish` (or your CI release pipeline) *after* deploying to Fly.
154
+
142
155
  `npm run verify:release` is the release gate. It checks:
143
156
  - allowlist freshness against OpenAPI
144
157
  - schema pack freshness
@@ -167,8 +180,8 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
167
180
  - Allowlisted operations: **97**
168
181
  - Methods: `GET=41`, `POST=56`, `PUT=0`, `PATCH=0`, `DELETE=0`
169
182
  - Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **13**
170
- - Typed tools: `auth.login`, `auth.logout`, `auth.status`, `ephemeris.electional`, `ephemeris.moon_phase`, `ephemeris.natal_chart`, `ephemeris.next_eclipse`, `ephemeris.relocation`, `ephemeris.synastry`, `ephemeris.transits`, `human_design.chart`
171
- - Generic tools: `dev.call`, `dev.list_allowed`
183
+ - Typed tools: `auth_login`, `auth_logout`, `auth_status`, `dev_call`, `dev_list_allowed`, `ephemeris_electional`, `ephemeris_moon_phase`, `ephemeris_natal_chart`, `ephemeris_next_eclipse`, `ephemeris_relocation`, `ephemeris_synastry`, `ephemeris_transits`, `human_design_chart`
184
+ - Generic tools:
172
185
 
173
186
  ### Allowlist Families
174
187
 
@@ -192,3 +205,10 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
192
205
  | `vedic` | 1 | `POST /vedic/chart` |
193
206
  | `visualization` | 2 | `POST /visualization/bi-wheel`, `POST /visualization/chart-wheel` |
194
207
  <!-- GENERATED:RUNTIME_SNAPSHOT:END -->
208
+
209
+
210
+ NPM publish
211
+
212
+ publish from /c/src/openephemeris/apps/api/mcp-server
213
+ npm login
214
+ npm publish