AstroAPI

Appearance

MCPサーバー：AIアシスタントからAstroAPIを利用する ​

AstroAPIは、ホスティング型のModel Context Protocol（MCP）サーバーを提供しています。Claude Code、Claude Desktop、CursorなどのAIアシスタントに接続すると、アシスタントがAstroAPIを直接呼び出せるようになります。出生地の検索、チャートの計算、結果のわかりやすい説明まで行えます。

これは、インテグレーションを構築する最速の方法でもあります。MCPサーバーをAIコーディングアシスタントに接続し、インテグレーションコードの作成を依頼してください。アシスタントは作業中に実際のAPI呼び出しを行えるため、推測ではなく実際のレスポンスを確認しながら進められます。

コード不要

接続が完了すれば、「1990年6月15日14時30分にアムステルダムで生まれた人の出生チャートを計算して」のように尋ねるだけで、アシスタントが場所を解決し、APIを呼び出して結果を要約してくれます。

エンドポイント ​

https://mcp.astroapi.cloud/mcp
  • トランスポート：Streamable HTTP
  • 認証：通常のAstroAPIキーをX-Api-Keyヘッダーで送信します
  • ご契約のサブスクリプションのモジュール、レート制限、クォータは、APIを直接呼び出す場合とまったく同様に適用されます。

APIキーはダッシュボードのAPI Keysで作成できます。詳細は認証をご覧ください。

Claude Codeへの接続 ​

ターミナルで次のコマンドを一度実行してください。

bash
claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

あとはClaude CodeにAstroAPIの利用を依頼するだけです。例：「astroapiのツールを使って、1990-06-15 14:30 アムステルダムの出生チャートを計算し、それを表示するReactコンポーネントを作って」

Cursorへの接続 ​

プロジェクト内の.cursor/mcp.json（またはグローバルに設定する場合は~/.cursor/mcp.json）に次を追加してください。

json
{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

その他のMCPクライアントへの接続 ​

カスタムヘッダー付きのStreamable HTTPによるMCPに対応しているクライアントであれば、どれでも利用できます。次のように設定してください。

設定値
URLhttps://mcp.astroapi.cloud/mcp
トランスポートStreamable HTTP
ヘッダーX-Api-Key: YOUR_API_KEY

カスタムヘッダーに対応していないホスティング型クライアント

一部のホスティング型クライアント（claude.aiのWebコネクタなど）はカスタムヘッダーを送信できず、OAuthが必要です。OAuth対応はロードマップに含まれていますが、当面はClaude Code、Claude Desktop、Cursorなど、カスタムヘッダーに対応したクライアントをご利用ください。

利用可能なツール ​

ツール機能
astro_resolve_place地名を検索し、座標とIANAタイムゾーンを返します。アシスタントは最初にこのツールを呼び出すよう指示されているため、座標を推測することはありません。
astro_natal_chart出生チャート（ポイント、ハウス、アスペクト）を計算し、オプションで解釈テキストも含め、コンパクトで読みやすい要約を返します。
astro_synastry2つの出生チャートを比較し、チャート間のアスペクトを双方向で一覧にします。
astro_compositeコンポジット（ミッドポイント）の関係性チャートを、独自の位置とアスペクトとともに計算します。
astro_transits期間内（最大2年）の出生チャートに対するトランジットを検索し、アスペクトごとに開始日・正確日・終了日を返します。
astro_compatibility2人の太陽星座に基づく簡易的な相性スコアです。
astro_solar_return指定した年のソーラーリターンチャート（占星術における誕生日のチャート）です。
astro_lunar_return指定した日付以降のルナーリターンチャート（およそ毎月）です。
astro_progressions対象日のセカンダリープログレッションで、出生チャートとのアスペクトを含みます。
astro_human_design完全なヒューマンデザインのボディグラフ：タイプ、戦略、権威、プロファイル、センター、チャンネル、ゲート。
astro_moon_sun指定した日付と場所について、月相に加えて出没時刻、太陽の南中、薄明の時刻を返します。
astro_moon_calendar日別レポート（星座、月相、ボイドタイム）、または期間内の月相、星座の移動、ボイド期間の概要を返します。
astro_retrograde_calendar逆行期間を、留の日付、通過する星座、シャドウ期間とともに返します。
astro_chinese_horoscope中国の干支と五行、または年間予測を返します。
astro_numerology生年月日と名前から完全な数秘術プロファイルを、またはライフパスナンバーのみを返します。
astro_numerology_compatibilityライフパスナンバーに基づく2人の相性です。
astro_horoscope事前に用意された日別・週別・年間・年間アセンダント別のホロスコープレポートです。
astro_ai_summary最も強い配置とアスペクトから、ホロスコープが何を意味するかを短くまとめます。AI Summary モジュールが必要です。

さらに多くのツール（アストロカートグラフィー、チャート画像など）を準備中です。ツールの利用可否はサブスクリプションのモジュールに従います。ご契約のプランに含まれないツールは、データの代わりにわかりやすいメッセージを返します。

セッション例 ​

接続済みのアシスタントとの会話は、次のようになります。

あなた： 1985年3月3日6時45分にバルセロナで生まれた人の太陽星座とアセンダントを教えてください。

アシスタント： 「Barcelona」でastro_resolve_placeを呼び出し、続いて解決された座標とタイムゾーンでastro_natal_chartを呼び出します — 太陽は魚座12°41′で第1ハウスにあり、アセンダントは水瓶座28°10′です…

ジオコーディング、タイムゾーン変換、API呼び出しといった、出生データを手入力する際に間違えやすい処理は、すべてアシスタントが行います。

次のステップ ​

AstroAPI Documentation

Copyright © 2026 AstroAPI