ephemeris-mcp/AGENTS.md

Ephemeris MCP

This repo is a standalone celestial computation service exposed through MCP. v0.1 is the core sky-state slice only; satellite work is planned but deferred.

Working rules

• Keep the core contract narrow: compute raw astronomical data and return structured JSON.
• Do not add interpretation layers here. Astrology, charting, narrative output, and consumer-specific meaning belong in downstream projects.
• Prefer small, deterministic changes that preserve the existing tool surface and cache behavior.
• Keep time, location, and sky-state calculations internally consistent across tools.
• Keep planned future slices in the docs and plan, even when they are out of v0.1.
• Treat the wiki as the companion source of project context, not a duplicate code dump.

Primary references

• Wiki project page: /home/lucky/wiki/entities/projects/ephemeris-mcp.md
• Wiki schema: /home/lucky/wiki/SCHEMA.md
• Wiki index: /home/lucky/wiki/index.md

Repo shape

• main.py starts the app.
• src/ephemeris_mcp/ holds the runtime code.
• tests/ holds verification.
• run.sh, restart.sh, killserver.sh, and tests.sh are the operational entry points.

Practical expectations

• Keep the implementation aligned with the plan in IMPLEMENTATION_PLAN.md.
• Keep README.md and the wiki project page aligned with the shipped slice.
• Prefer explicit, reproducible behavior over hidden heuristics.
• If a change affects the public tool surface or data model, update the repo docs in the same pass.