caelus-mcp について
caelus-mcpは、Caelus TypeScriptエンジンを基盤とする占星術計算用MCPサーバーです。チャート、トランジット、タイミング技法、ヴェーダ占星術の計算、引用可能なチャート情報を必要とするユーザーや開発者を対象とし、Swiss Ephemerisのコードや天文暦ファイルを含まないクリーンルーム実装と説明されています。
主な機能
- 01チャートとトランジットの計算
- 02シナストリー、イベント、食の計算
- 03ヘレニズム占星術のタイミング技法
- 04ヴェーダ占星術の手法
- 05引用可能なチャート情報と天空ビュー用フレーム
活用シーン
- 01占星術チャートを生成
- 02トランジットや食を調べる
- 03チャート間のシナストリーを計算
- 04引用用のチャート情報を生成
MCP 対応
`caelus-mcp`パッケージは、チャート、トランジット、シナストリー、イベント、食に関するMCPツールを提供します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://www.ephemengine.com/api/mcpclaude mcp add --transport http heavyblotto-caelus https://www.ephemengine.com/api/mcp{"mcpServers":{"heavyblotto-caelus":{"type":"http","url":"https://www.ephemengine.com/api/mcp"}}}Cursor で開く{"servers":{"heavyblotto-caelus":{"type":"http","url":"https://www.ephemengine.com/api/mcp"}}}VS Code で開く{"mcpServers":{"heavyblotto-caelus":{"type":"http","url":"https://www.ephemengine.com/api/mcp"}}}{"mcpServers":{"heavyblotto-caelus":{"serverUrl":"https://www.ephemengine.com/api/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
35| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| lat | number | はい | 緯度。北緯を正とします。 |
| lon | number | はい | 経度。東経を正とします（南北アメリカは負）。 |
| date | string | はい | UTC の日時。ISO 8601 形式。例：1990-06-10T14:30:00Z。現地の出生時刻を先に UTC に変換してください。 |
| grid | enum | いいえ | 標準グリッド（output:'canonical' と併用）：arcsec（デフォルト）、milliarcsec、centideg、dms（[deg,min,sec] の三つ組）、または accuracy（各天体を検証済みの測定精度に丸めます。クロスプラットフォームのコンテンツアドレッシングに最も適した選択肢です）arcsec | milliarcsec | centideg | dms | accuracy |
| output | enum | いいえ | 'float'（デフォルト）は通常の浮動小数点ペイロードを返します。'canonical' は、指定グリッド上の整数と sha256 ダイジェストを返します。マシン／ブラウザー／言語間で安定し、キャッシュや重複排除のためにハッシュ化でき、精度を正確に保ちます。サイン／ハウス／アスペクトは量子化値から再導出されるため、表示される数値と事実は常に一致します。float | canonical |
| zodiac | enum | いいえ | tropical（デフォルト）または sidereal:<ayanamsa>tropical | sidereal:lahiri | sidereal:fagan_bradley | sidereal:krishnamurti | sidereal:raman | sidereal:yukteshwar | sidereal:galcent_0sag | sidereal:true_citra |
| remainders | enum | いいえ | output:'canonical' の場合：余りセットも返します。量子化で破棄された量子未満の整数残差で、リーフパスをキーとし、ペイロードダイジェストにひも付けられます。'auto' は基準より1段階細かいグリッドを選択します。または、より細かいグリッドを指定できます（必ず厳密に細かいものを指定）。残差は累積可能です。composeRemainders(payload, remainders) により、より細かいグリッド上のペイロードを正確に再構築できます。時間の残差は整数マイクロ秒、距離の残差は整数 nano-AU です。auto | arcsec | milliarcsec |
| separation | enum | いいえ | アスペクトの分離角：'longitude'（デフォルト。黄道上のアスペクト）または 'spatial'（黄緯を考慮した真の大円分離角。月、冥王星、黄道から大きく離れた天体では結果が異なります）。longitude | spatial |
| house_system | string | いいえ | ハウスシステム（デフォルトは placidus）。大文字と小文字、空白の違いは無視されます。有効な値：placidus、whole_sign、equal、porphyry、koch、regiomontanus、campanus、alcabitius、morinus、meridian、polich_page、vehlow（"whole sign" などの別名も使用できます）。 |
詳細
Caelus
クリーンルーム方式で開発された占星術計算モノレポです。MIT ライセンスで、Swiss Ephemeris のコード、AGPL、エフェメリスファイルは含みません。Caelus はエフェメリス位置、チャート、イベント、ヘレニズム占星術のタイミング技法、ヴェーダ占星術の手法、引用可能なチャート情報、空の眺望画像用プロンプトフレーム、およびそれらを扱う MCP ツールを計算します。公開先： ephemengine.com。
パッケージ
| パス | npm | 説明 |
|---|---|---|
packages/caelus | caelus | TypeScript エンジン（圧縮後合計約 153 KB、依存関係ゼロ） |
packages/caelus-mcp | caelus-mcp | MCP サーバー：チャート、トランジット、シナストリー、イベント、日食・月食 |
packages/caelus-delineations-pd | — | パブリックドメインの解釈コーパスと、interpret() のデフォルト検証セット |
packages/birth | caelus-birth | 出生時刻と場所 → UT（タイムゾーンと夏時間の解決） |
packages/wheel | caelus-wheel | React SVG チャートホイール、実行時依存関係ゼロ |
apps/web | — | Next.js サイト：プレイグラウンド、検証、エッジ /api/chart |
caelus-starter | — | Next.js スターターアプリ（別リポジトリ） |
Python 参照エンジンとデータフィッティングパイプラインは python/ にあります。係数データとゴールデンフィクスチャを生成し、実行時の依存関係ではありません。
ドキュメント
- ARCHITECTURE.md — 構成、耐久性に関する判断、製品戦略
- MCP_SPEC.md — MCP ツールの仕様
- docs/gap-analysis.md — Swiss Ephemeris との比較（0.5.0 で完了）
- docs/agents.md — Caelus を基盤に構築するコーディングエージェント向けの注意点
- docs/releasing.md — リリース手順
クイックスタート
npm install
npm run build
npm test
npm run dev -w web
http://localhost:3000 — ブラウザーでライブチャートを表示します。
エッジ API：GET /api/chart?date=…&lat=…&lon=…。
ブランチ
main— 安定版リリースdev— 開発中
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。