English Français العربية

io.github.heavyblotto/caelus-mcp

السجل الرسمي الخرائط والسفر والطقس

34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http caelus-mcp 'https://www.ephemengine.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "caelus-mcp": {
            "type": "http",
            "url": "https://www.ephemengine.com/api/mcp"
        }
    }
}
NPM package caelus-mcp
Claude Code 
claude mcp add caelus-mcp -- npx -y caelus-mcp@0.24.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "caelus-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "caelus-mcp@0.24.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Caelus
  2. Packages
  3. Docs
  4. Quick start
  5. Branches

Caelus

Clean-room astrology computation monorepo. MIT, no Swiss Ephemeris code, no AGPL, no ephemeris files. Caelus computes ephemeris positions, charts, events, hellenistic timing techniques, Vedic methods, citable chart facts, sky-view image-prompt frames, and the MCP tools around them. Live at ephemengine.com.

Packages

PathnpmDescription
packages/caeluscaelusTypeScript engine (~153 KB gzipped total, zero deps)
packages/caelus-mcpcaelus-mcpMCP server: charts, transits, synastry, events, eclipses
packages/caelus-delineations-pd—Public-domain interpretation corpus + default validation set for interpret()
packages/birthcaelus-birthBirth time + place → UT (timezone and DST resolution)
packages/wheelcaelus-wheelReact SVG chart wheel, zero runtime deps
apps/web—Next.js site: playground, validation, edge /api/chart
caelus-starter—Next.js starter app (separate repo)

The Python reference engine and data-fitting pipeline live in python/; they mint the coefficient data and golden fixtures and are not a runtime dependency.

Docs

Quick start

npm install
npm run build
npm test
npm run dev -w web

http://localhost:3000 — live chart in the browser. Edge API: GET /api/chart?date=…&lat=…&lon=….

Branches

  • main — stable releases
  • dev — active development

الأسئلة الشائعة

ما هو io.github.heavyblotto/caelus-mcp؟

34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.

كيف أثبّت io.github.heavyblotto/caelus-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http caelus-mcp 'https://www.ephemengine.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.heavyblotto/caelus-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.heavyblotto/caelus-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.heavyblotto/caelus-mcp؟

ينشره heavyblotto. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.