LunarGarden MCP

A public Model Context Protocol (MCP) server for astrology-aware garden care planning.

LunarGarden combines real external astrology data (lunar phase + Vedic panchang), hourly weather + soil forecasts, and static soil profiles into a structured 24-72 hour care plan with rationales and confidence scores.

Stack

• Cloudflare Worker (src/worker.js)

• Model Context Protocol server (JSON-RPC 2.0 over HTTP at /mcp)

• Same-origin frontend (index.html, styles.css, app.js) served from the Worker

• Caching via Cloudflare KV with in-memory fallback for local development

Related MCP server: PlantOntology

External APIs

MCP Tools

Full schemas, input/output contracts, and example calls are documented in /agents-guide.md (served at the same origin).

Endpoints

Development

# Install
npm install

# Local dev server (memory cache, no real AstrologyAPI calls)
npx wrangler dev

# Production deploy (after explicit approval only)
npx wrangler deploy

Secrets (production)

wrangler secret put ASTROLOGY_API_USER_ID
wrangler secret put ASTROLOGY_API_KEY

Real AstrologyAPI calls are disabled unless both env vars are present AND the LIVE_ASTROLOGY environment variable is explicitly set to "true".

Safety

• All secrets live in Cloudflare Worker secrets, never in source.

• Same-origin only: the browser never calls upstream APIs directly.

• Cache TTL: lunar 1h, weather 15min, soil 24h, UV 15min.

• SoilGrids is fail-soft: empty profile does not block composite output.

• Invalid input returns HTTP 400 with a clear error.message.

License

MIT