astral-mcp

ローカル

github.comゲーム・エンタメ08 週間前に更新

リポジトリ公式サイト

astral-mcp について

astral-mcpは、AIエージェント向けにネイタルチャート、トランジット、シナストリー、月相を提供するローカル実行の占星術MCPサーバーです。2種類の天文暦でネイタルチャートを独立検証し、解釈文ではなく構造化データを返します。

主な機能

01精度監査付きネイタルチャートの計算
02現在および今後のトランジット確認
032つのネイタルチャートの比較
04指定日の月相を表示
05場所のジオコーディングと機能情報

活用シーン

01監査情報付きのネイタルチャートデータを生成
02チャートに影響する現在のトランジットを確認
032件の出生データを比較
04指定日の月相と照度を調べる

MCP 対応

MCPを通じて、チャート、トランジット、シナストリー、月相、出生地検索のツールをAIエージェントに提供します。標準のstdioに加え、Streamable HTTPも選べます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "davidmosiah-astral": {
      "command": "npx",
      "args": [
        "-y",
        "astral-mcp"
      ],
      "env": {
        "ASTRAL_MCP_TRANSPORT": "<ASTRAL_MCP_TRANSPORT>",
        "ASTRAL_MCP_HOST": "<ASTRAL_MCP_HOST>",
        "ASTRAL_MCP_PORT": "<ASTRAL_MCP_PORT>",
        "ASTRAL_MCP_ALLOWED_ORIGIN": "<ASTRAL_MCP_ALLOWED_ORIGIN>"
      }
    }
  }
}

起動コマンドnpx -y astral-mcp

設定が必要な環境変数

ASTRAL_MCP_TRANSPORTTransport to run. Defaults to stdio. Set to http to expose a streamable HTTP endpoint instead.

ASTRAL_MCP_HOSTHost to bind when ASTRAL_MCP_TRANSPORT=http. Defaults to 127.0.0.1.

ASTRAL_MCP_PORTPort to bind when ASTRAL_MCP_TRANSPORT=http. Defaults to 3000.

ASTRAL_MCP_ALLOWED_ORIGINAllowed CORS origin for the HTTP transport. Defaults to the bound host:port.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmastral-mcp0.2.0stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
zodiac	enum	いいえ	黄道方式。'tropical'（西洋占星術、季節基準）または 'sidereal'（ヴェーダ占星術／星座基準）。tropical \| sidereal
latitude	number	はい	出生地の緯度を十進度で指定します。範囲は -90..90 です。不明な場合は、都市名を使って astral_search_birthplace で特定してください。
timezone	string	はい	出生時の出生地の IANA タイムゾーン。例：America/Fortaleza。呼び出し元のタイムゾーンではありません。astral_search_birthplace は各候補についてこの値を返します。
longitude	number	はい	出生地の経度を十進度で指定します。範囲は -180..180（負の値 = 西経）です。不明な場合は astral_search_birthplace で特定してください。
birth_date	string	はい	出生年月日を YYYY-MM-DD 形式で指定します。例：1989-02-23。1900 年より前および 2100 年より後の年にも対応しますが、精度は低くなります。
birth_time	string	いいえ	現地の出生時刻を24時間制の HH:MM 形式で指定します。例：14:30。省略可能です。不明な場合は正午として扱われ、ハウス／アセンダントの精度は低下します（惑星の位置は正確なままです）。
house_system	enum	いいえ	ハウスシステム。'placidus' は現代のデフォルト、'whole-sign' は伝統占星術／ヘレニズム占星術で一般的です。その他：koch、campanus、regiomontanus、topocentric、equal-house。placidus \| koch \| campanus \| regiomontanus \| topocentric \| equal-house \| whole-sign
privacy_mode	enum	いいえ	ペイロードの詳細度。response_format（Markdown と JSON のどちらで出力するかのみを選択）とは独立して、返す出生図データの量を指定します。'full'（デフォルト）は完全なペイロードを返します。すべての惑星、ハウス、アスペクトと、惑星ごとの精度監査が含まれます。'structured' は完全な構造を保ちながら、冗長なフィールドや導出可能なフィールド（絶対経度、エレメント／モダリティ、精度監査の行）を省き、機械処理向けに軽量化します。'summary' はトークン節約のため、重要な要点（太陽と月＋アセンダント、優勢なエレメント／モダリティ、チャートパターン、主要アスペクト、精度ステータス）のみを返します。簡単に確認する場合は 'summary'、すべての配置が必要な場合は 'full' を指定してください。summary \| structured \| full
response_format	enum	いいえ	出力形式。'markdown' は表示用の読みやすい概要を返し、'json' は後続処理用に完全な構造化出生図を返します。markdown \| json
verify_precision	boolean	いいえ	true の場合（デフォルト）、第2のエフェメリスを使って各惑星を独立して再計算し、精度監査を付加します。false に設定すると照合をスキップします。

詳細

Astral MCP

AI エージェントに本格的な占星術を提供します — ネイタルチャート、トランジット、シナストリー、月相に対応。
ローカルで計算し、独立した2つの天体暦で相互検証します。API キーもアカウントも不要です。

⚡ セットアップ不要でインストールできます。 Claude Desktop / Cursor / Hermes に接続すれば、すぐに呼び出せます — API キー、OAuth、アカウントは不要です： npx -y astral-mcp

出生データを、精度監査済みの完全な占星術リーディングに変換する、ローカル優先の MCP サーバーです。 ステートレスで計算のみを行い、データは保存されず、認証情報も存在しません。オプションのジオコーディングを除き、すべてのツールが完全にオフラインで動作します。

Astral MCP は、Delx の占星術に特化した製品です。独立した Protocol、Security、Wellness、Commerce の各プロパティとの境界については、Delx プラットフォームマップをご覧ください。

David Mosiah が開発しました。占星術エンジンは、Alkhemia アプリから移植されています。

このプロトコルのパターンを初めてお使いですか？ **占星術 MCP サーバーとは？**を読んで、決定論的なチャート計算とモデルによる解釈の分離、推奨されるエージェントのワークフロー、精度とプライバシーの境界についてご確認ください。

チャートを計算してみませんか？ **MCP でネイタルチャートを作成する方法**では、正確な出生地、タイムゾーン、出生時刻不明の場合の扱い、ペイロード、精度監査のワークフローについて説明しています。

機密性の高い入力を扱いますか？ **占星術エージェントのワークフローで出生データを保護する方法**を読んで、ペイロードの最小化、ローカル計算、オプションの OpenStreetMap との境界、privacy_mode=summary の制限についてご確認ください。

これを開発した理由

多くの占星術ライブラリは脆弱な単一エンジンのラッパーであり、多くの「占星術 API」はキーとサブスクリプションを要求します。エージェントには、信頼できてすぐに呼び出せるものが必要です。Astral MCP は次の2点で異なります。

すぐに使えます。 npx -y astral-mcp を実行すれば、チャートを呼び出せます — OAuth もアカウントも、インストールが必要な出生地データベースもありません。
自ら検証します。 すべてのネイタルチャートを1つの天体暦で計算した後、別の天体暦を使って惑星ごとに独立して再計算します。両者の差が厳密な許容範囲を超えた場合、誤った配置を黙って返すのではなく、チャートに review のフラグを付けます。

60 秒でセットアップ

お使いの MCP クライアント（Claude Desktop、Cursor、Hermes など）に追加します。

{
  "mcpServers": {
    "astral": {
      "command": "npx",
      "args": ["-y", "astral-mcp"]
    }
  }
}

セットアップはこれだけです。認証は必要ありません。

必要であれば、直接実行できます。

npx -y astral-mcp                      # stdio (default)
ASTRAL_MCP_TRANSPORT=http npx -y astral-mcp   # streamable HTTP on 127.0.0.1:3000

接続前に確認する

astral_demo を呼び出すと、精度監査付きの完成したサンプルチャート（グリニッジ、正午、Y2K）が表示されます。入力、ネットワーク、認証は不要です。実際の出生データを送信する前に、正確なペイロード形式を確認できます。

エージェントで試す

「私の出生図は？ 1989年2月23日14:30にブラジルのフォルタレザで生まれました。」

エージェントは astral_search_birthplace を呼び出してフォルタレザを緯度・経度・タイムゾーンに変換し、続いて astral_compute_natal_chart を呼び出します。

「今週、私のチャートに大きなトランジットはありますか？」 → astral_current_transits 「私たちの相性はどうですか？」（2人分の出生データ） → astral_synastry 「今日の月相は？」 → astral_moon_phase

精度

Astral MCP は、すべての出生図に精度監査を付けて提供します。主要エンジン（circular-natal-horoscope-js）がチャートを計算し、検証エンジン（astronomy-engine）が各惑星の黄経を独立して再計算します。すべての惑星の値が許容誤差内で一致し、同じサインに位置する場合にのみ、チャートは verified になります。

1945～2010年のチャートと6つのタイムゾーンを網羅する組み込み精度テストでは、エンジン間の最大誤差は0.01°未満です。次のコマンドで実行できます。

npm run test:accuracy

データの利用可否

機能	対応状況
惑星（太陽～冥王星）、アセンダント、MC/IC	✅
ハウス（プラシーダス、コッホ、カンパナス、レギオモンタヌス、トポセントリック、イコールハウス、ホールサイン）	✅
オーブ、強度、接近中／分離中の情報を含む主要アスペクト	✅
チャートの特徴（優勢なエレメント／モダリティ、パターン、ステリウム、アングル上の惑星）	✅
逆行 · タイムゾーン／DST の処理	✅
トランジット（現在＋今後） · 月相	✅
シナストリー（2つのチャートの比較、スコア付き）	✅
トロピカル方式とサイデリアル方式の黄道帯	✅
月のノード、キロン、小惑星、恒星	⏳ 予定
マイナーアスペクト	⏳ 予定
解釈文	❌ 設計上の仕様 — astral-mcp は構造化データを返し、リーディングはお使いのモデルが作成します

ツール

astral_compute_natal_chart — 出生図全体を返します。デフォルトで精度監査付き
astral_current_transits — チャートに対する現在および今後のトランジットを、月相とともに返します
astral_synastry — 2つのチャートを比較します（調和／相性／コミュニケーション／成長）
astral_moon_phase — 任意の日付の月相、サイン、照度を返します
astral_search_birthplace — 地名を緯度／経度／タイムゾーンにジオコーディングします
astral_demo — 入力不要の完成したサンプルチャート
astral_capabilities — このサーバーの対応機能と非対応機能
astral_data_inventory — データ領域と最初に呼び出すことを推奨するツール
astral_agent_manifest — エージェント向けのインストールおよび使用ルール
astral_connection_status — サンプルチャートと二重エンジン監査によるヘルスチェック

3つのチャートツール（astral_compute_natal_chart、astral_current_transits、astral_synastry）は、response_format とは別のペイロード詳細度を指定する privacy_mode パラメーターを受け取ります。

full（デフォルト）— 惑星ごとの精度監査を含む完全なペイロード
structured — 同じ構造で、重複するフィールドや算出可能なフィールドを除外
summary — 重要度の高い要点のみ（天体光源＋アセンダント、チャートの特徴、主要アスペクト）

グリニッジの出生図の完全なペイロードは約6.9 KBです。summary は約1.2 KB（約80％小さい）なので、簡単な確認だけでよいエージェントは、必要な情報を絞ってトークンを節約できます。

正確なリーディングのための注意事項

呼び出し元のタイムゾーンではなく、出生地のタイムゾーンを指定してください。astral_search_birthplace が返します。
birth_time は省略可能です。省略した場合は正午とみなされます。惑星のサインは正確ですが、アセンダントとハウスの精度は保証されません。

プライバシーとセキュリティ

Astral MCP は何も保存せず、秘密情報も保持しません。唯一の任意のネットワーク呼び出しは astral_search_birthplace（OpenStreetMap）で、送信されるのは渡された場所の名前だけです。SECURITY.md を参照してください。

コントリビューション

src/engine/ の計算コアは Alkhemia から移植されたものです。フレームワークに依存しない状態を保ってください。開発ルールとテストゲート（npm test）については、AGENTS.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。

HTTP（v2 ステートレス）

デフォルトは stdio です。オプションで Streamable HTTP を利用できます。セッション ID なし、JSON レスポンス、ループバックのみです。

npx -y astral-mcp --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

環境変数：ASTRAL_MCP_HOST、ASTRAL_MCP_PORT、ASTRAL_MCP_TRANSPORT=http。

スキルまたは MCP

npx -y astral-mcp call astral_connection_status --json '{}'

Markdown 対応

ログインしてコメント

基本情報

作者: davidmosiah
言語: node
バージョン: 0.2.0
トランスポート: stdio
掲載日: 2026年6月7日
最終更新: 8 週間前
公式 Registry: io.github.davidmosiah/astral-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。