Open Ephemeris

Open Ephemeris MCP サーバー

Claudeで使用する： https://mcp.openephemeris.com/mcp をカスタムコネクターとして追加します（OAuth Client IDとSecretは空欄のままにします）。または、ClaudeディレクトリからOpen Ephemerisプラグインをインストールします。ブラウザーでサインインすると、150クレジット付きの無料アカウントが作成されます。

Open Ephemeris用のModel Context Protocolサーバーです。NASA JPL DE440天体暦を利用した、型定義済みの占星術ツールを提供します。惑星の位置、日付、度数に関するハルシネーションはゼロです。1,100年分の天文データを網羅しています。

ホスト型エンドポイント： https://mcp.openephemeris.com/mcp（Streamable HTTP、MCP 2025-11-25仕様）

クイックスタート

Smithery経由でインストール（推奨）

MCP対応クライアントを接続する最も手早い方法です。

npx -y @smithery/cli install @open-ephemeris/openephemeris --client claude

または、リストを確認して接続用スニペットをコピーしてください：smithery.ai/servers/open-ephemeris/openephemeris

---

AI SDK経由で接続（Vercel AI SDK）

import Smithery from "@smithery/api"
import { createMCPClient } from "@ai-sdk/mcp"
import { generateText } from "ai"
import { anthropic } from "@ai-sdk/anthropic"
import { createConnection } from "@smithery/api/mcp"

const smithery = new Smithery()

const conn = await smithery.connections.create("{your-namespace}", {
  mcpUrl: "https://server.smithery.ai/open-ephemeris/openephemeris",
  headers: {
    apiKey: "your-openephemeris-api-key", // get one free at openephemeris.com/dashboard
  },
})

const { transport } = await createConnection({
  client: smithery,
  namespace: "{your-namespace}",
  connectionId: conn.connectionId,
})

const mcpClient = await createMCPClient({ transport })
const tools = await mcpClient.tools()

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-20250514"),
  tools,
  prompt: "Calculate a natal chart for someone born April 15, 1990 at 2:30 PM in Chicago.",
})

await mcpClient.close()

MCP SDK経由で接続（TypeScript）

import Smithery from "@smithery/api"
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { createConnection } from "@smithery/api/mcp"

const smithery = new Smithery()

const conn = await smithery.connections.create("{your-namespace}", {
  mcpUrl: "https://server.smithery.ai/open-ephemeris/openephemeris",
  headers: {
    apiKey: "your-openephemeris-api-key",
  },
})

const { transport } = await createConnection({
  client: smithery,
  namespace: "{your-namespace}",
  connectionId: conn.connectionId,
})

const mcpClient = new Client(
  { name: "my-app", version: "1.0.0" },
  { capabilities: {} }
)
await mcpClient.connect(transport)

const { tools } = await mcpClient.listTools()
const result = await mcpClient.callTool({
  name: "ephemeris_natal_chart",
  // A datetime that states a clock time must state its zone: either pass
  // `timezone` alongside the local time, or put a Z/±HH:MM offset on the value.
  arguments: {
    datetime: "1990-04-15T14:30:00",
    timezone: "America/Chicago",
    latitude: 41.8781,
    longitude: -87.6298,
    format: "llm",
  },
})

直接接続（Streamable HTTP、Smithery不要）

import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { Client } from "@modelcontextprotocol/sdk/client/index.js"

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp.openephemeris.com/mcp"),
  { requestInit: { headers: { "X-API-Key": "your-openephemeris-api-key" } } }
)

const client = new Client({ name: "my-app", version: "1.0.0" }, { capabilities: {} })
await client.connect(transport)

---

ワンクリックインストール（Cursor）

CursorのMCP設定で、YOUR_API_KEY_HERE を https://openephemeris.com/dashboard から取得したAPIキーに置き換えてください。

Cursorディープリンクのペイロード：

{
  "command": "npx",
  "args": [
    "-y",
    "@openephemeris/mcp-server"
  ],
  "env": {
    "OPENEPHEMERIS_PROFILE": "dev",
    "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com",
    "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE"
  }
}

手動インストール（stdio MCPクライアント）

{
  "mcpServers": {
    "openephemeris": {
      "command": "npx",
      "args": ["-y", "@openephemeris/mcp-server"],
      "env": {
        "OPENEPHEMERIS_PROFILE": "dev",
        "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com",
        "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

プラットフォームガイド

各プラットフォームの詳しいセットアップ手順は、SETUP.mdをご覧ください。

クライアント	インストール方法	設定ファイルの場所
Smithery	ワンクリック	smithery.ai
Cursor	ワンクリックのディープリンクまたは手動	~/.cursor/mcp.json
Claude Desktop（macOS）	手動	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	手動	%APPDATA%\Claude\claude_desktop_config.json
Windsurf	手動	~/.codeium/windsurf/mcp_config.json（または旧形式の ~/.codeium/mcp_config.json）
ChatGPT	ワンクリック	ChatGPTアプリディレクトリのOpen Ephemeris
Claude Web／リモートクライアント	ホスト型URL	https://mcp.openephemeris.com/mcp

クライアントのインストール手順

1. Cursor
   • 上の「Install in Cursor」ボタンをクリックし、Cursor の MCP 設定で YOUR_API_KEY_HERE を置き換えます。
   • 手動で設定する場合は、「Manual install」の mcpServers.openephemeris ブロックを ~/.cursor/mcp.json に貼り付けます。
2. Claude Desktop（macOS/Windows）
   • 上の表から、お使いのプラットフォームの設定ファイルを開きます。
   • 「Manual install」の同じ mcpServers.openephemeris ブロックを追加します。
   • Claude Desktop を再起動します。
3. Windsurf
   • ~/.codeium/windsurf/mcp_config.json（または旧形式の ~/.codeium/mcp_config.json パス）を開きます。
   • 「Manual install」の mcpServers.openephemeris ブロックを追加します。
   • Windsurf を再起動します。

リモート専用クライアント（Claude Web、ChatGPT など）

サーバーは https://mcp.openephemeris.com/mcp でホストされており、Streamable HTTP を完全にサポートしています（MCP 2025-11-25 仕様）。リモート専用クライアントは、ブリッジやプロキシを介さずに直接接続できます。

• Claude Web：「https://mcp.openephemeris.com/mcp」をカスタムコネクター URL として追加し、OAuth Client ID と Secret は空欄にします。サーバーは OAuth 2.1 + PKCE（Dynamic Client Registration）を使用しているため、Claude がブラウザーのポップアップを介して自動的に認証を処理します。
• ChatGPT：Open Ephemeris は ChatGPT アプリディレクトリで承認済みのアプリです。 掲載ページを開き、Install plugin をクリックしてサインインを承認すると（この操作で無料の Open Ephemeris アカウントも作成されます）、任意のチャットで @Open Ephemeris と入力できます。チャートは Claude と同じようにインラインで表示されます。自分で接続を設定する場合は、Settings → Plugins → Advanced → Developer mode → + Create app で https://mcp.openephemeris.com/mcp を指定し、認証方式に OAuth を選択します。クライアント ID や Secret の入力は不要です。
• Smithery 経由：任意のクライアントとのマネージド接続には、Smithery の掲載ページを使用します。
• レガシー SSE：3.20.0 で廃止されました。/mcp の Streamable HTTP を使用してください。

MCP クライアントでの認証とアップグレードの動作

• 認証情報がない、または無効な場合（401）：ツールの呼び出しは失敗し、ユーザーに https://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount でサインアップまたはサインインした後、https://openephemeris.com/dashboard?tab=account でキーを作成・管理するよう案内するメッセージが表示されます。
• エンドポイントの利用に上位プランが必要な場合（403）：ツールの呼び出しは、https://openephemeris.com/pay およびダッシュボードの請求・キー管理ページへのリンクを含む、アップグレードを求めるメッセージを返します。
• クレジット不足の場合（402）：ツールの呼び出しはワンタップのクレジット追加リンクを返します（Explorer の無料クレジット 150 は一度限りで、リセットされません。プランの利用枠は請求期間ごとに更新されます）。ダッシュボードの利用状況ページへのリンクも含まれます。失敗した呼び出し（すべての 4xx／5xx）は返金されます。
• バースト／レート制限の場合（429）：ツールの呼び出しは再試行の案内と、ダッシュボードの利用状況モニタリングへのリンクを返します。

質問できること

"Calculate a natal chart for 1990-04-15 at 2:30 PM in Chicago."
"Find all Saturn transits to my natal Sun in the next 6 months."
"Get the current moon phase and void-of-course status."
"Find the next solar eclipse visible from Tokyo."
"Find the best time to sign a contract in March — electional window."
"Generate a Human Design chart for my birth data."
"What is my Vedic (sidereal) chart?"
"Calculate my Chinese BaZi (Four Pillars) chart."
"Show me my Astrocartography power lines — where is my Venus line on the map?"
"Find all ACG lines within 3° of Paris for my chart."
"Calculate a synastry chart between two people."
"Find the next Venus Star Point and my relationship to it."
"What are the active planetary stations in the next 3 months?"
"Calculate primary directions for the next 5 years."
"Find my Firdaria time lord period."
"What is the sidereal time and delta-T right now?"

インタラクティブチャート

9つのツールはJSONで回答しません。会話内にチャートを開きます。同じ計算結果から描画された本物のチャートで、クリックして操作できます。

これは、思っている以上に重要です。JSONで返されたネイタルチャートは、読み解くためにあらかじめ理解しておく必要のある数値の一覧です。同じチャートをホイールとして表示すれば、指し示して確認できます。惑星をクリックするとその配置の説明が表示され、ハウスをクリックするとその中にあるものが表示されます。会話を続けている間もチャートは画面に表示されたままで、見続けても追加のクレジットはかかりません。

これらを使うには、MCP Apps に対応したホストが必要です。Claude と ChatGPT はどちらも対応しており、同じウィジェットを表示します。ChatGPT 用に別のビルドはありません。MCP Apps (SEP-1865) は Anthropic と OpenAI が共同で作成し、2026年1月に初の公式 MCP 拡張機能となりました。そのため、1つの ui:// リソースで両方に対応できます。ChatGPT ではアプリディレクトリからインストールし、Claude ではコネクターを追加してください（SETUP.md を参照）。

アプリに対応していないクライアントでも、同じツールを引き続き利用できます。図の代わりに基礎データが表示されるため、何も壊れません。ただし、ホイールは表示されません。

ツール	開くもの	クリックできるもの	クレジット
explore_natal_chart	ネイタルホイール — 惑星、ハウス、アスペクト、アングル	惑星、ハウス、アスペクトライン。新しい設定で再計算	1
explore_bi_wheel	1つのホイール上に2つのチャートを表示：トランジット、シナストリー、プログレス	どちらのホイールの惑星やハウス、両者間のアスペクトもクリックできます	2（ソーラーリターン／ルナーリターンは6）
explore_human_design	マンダラ表示の切り替えができるヒューマンデザインのボディグラフ	センター、ゲート、チャネル、惑星、変数	4
explore_human_design_transit	今日の惑星をネイタルボディグラフに重ねて表示	トランジットによって活性化されたチャネル	5
explore_human_design_connection	2つのボディグラフを統合し、共有するすべてのチャネルを分類	タイプ別のコネクションチャネル	5
explore_vedic_chart	南インド式ラーシグリッド — サイデリアル方式の配置とラグナ	各ラーシと、その配置やナクシャトラ	3
explore_bazi_chart	四柱（四柱命式）— 年、月、日、時	各柱	3
explore_transit_timeline	今後のトランジットヒットを日付順に表示	個々のヒット	最長1年で6（期間に応じて料金が変わります）
explore_moon_phase	月のダイヤル — 照度、位相、サイン、ボイド・オブ・コース	別の時点で再計算	3

人に頼むときのように、これらを使うように頼んでください。「私のチャートを見せて」、「今日のトランジットを私のヒューマンデザインに重ねて」、*「今、月はどんな状態？」*などです。モデルがアプリを選びます。

知っておくとよいことが2つあります。チャートホイールとバイホイールでは、線で結ばれた2つの惑星だけでなく、アスペクトラインもクリックできます。そのため、「この線が重要なのはなぜ？」という疑問も、説明を長々と準備することなくワンクリックで確認できます。また、ボディグラフのマンダラ表示に切り替えると、APIを再度呼び出すことなくチャート全体が同心円状のリングに並べ替えられるため、表示の切り替えは無料です。

ツール一覧

カテゴリ	ツール	ティア
ネイタルチャート	ephemeris_natal_chart	Explorer
トランジット予測	ephemeris_transits	Explorer
トランジットチャートのスナップショット	ephemeris_natal_transits	Explorer
月相／VOC	ephemeris_moon_phase	Explorer
次に見られる日食・月食	ephemeris_next_eclipse	Explorer
イレクショナルの時間帯	ephemeris_electional	Pro
時点分析	electional_moment_analysis	Explorer
ステーショントラッカー	electional_station_tracker	Explorer
アスペクト検索	electional_aspect_search	Pro
Human Design チャート	human_design_chart	Explorer
HD コンポジット	human_design_composite	Explorer
HD トランジットオーバーレイ	explore_human_design_transit	Explorer
HD コネクション（シナストリー）	explore_human_design_connection	Explorer
HD ペンタ	human_design_penta	Explorer
HD リターン／オポジション	hd_planetary_return, hd_opposition	Explorer
ヴェーダチャート	vedic_chart	Explorer
四柱推命（中国式）	chinese_bazi	Explorer
シナストリー	ephemeris_synastry	Explorer
コンポジットチャート	ephemeris_composite	Explorer
リロケーションチャート	ephemeris_relocation	Explorer
プログレスチャート	ephemeris_progressed_chart	Explorer
ソーラーリターン	ephemeris_solar_return	Explorer
ルナリターン	ephemeris_lunar_return	Explorer
惑星リターン	ephemeris_planetary_return	Explorer
アストロカートグラフィーのライン	acg_power_lines	Pro
指定地点のACGヒット	acg_hits	Pro
金星スターポイント	venus_star_points + 4 more	Explorer
チャートホイール画像	ephemeris_chart_wheel	Explorer
バイホイール画像	ephemeris_bi_wheel	Explorer
ディグニティ／ミッドポイント／恒星	ephemeris_dignities, ephemeris_midpoints, ephemeris_fixed_stars	Explorer

ツールの仕組み

• 一般的なワークフロー（ネイタル、トランジット、月相、日食・月食、シナストリー、リロケーション、イレクショナル、Human Design）では、型付きツールを推奨します。
• 汎用ツール：dev_list_allowed は現在許可リストに登録されているすべての操作を返します。dev_read_api は許可リストに登録された GET（読み取り）操作を呼び出し、dev_write_api は許可リストに登録された POST/PUT/PATCH/DELETE（書き込み／計算）操作を、それぞれ method + path で呼び出します。読み取りと書き込みは別々のツールとして扱うため、安全な読み取り用の窓口が状態を変更する書き込みと同じツールを共有することはありません。
• セキュリティモデル：config/dev-allowlist.json に明示的な許可リストを設定したデフォルト拒否方式です。
• 拒否プレフィックスにより、機密性の高いルートファミリー（/auth、/billing、/admin など）をブロックします。

dev_read_api ／ dev_write_api の入力

パラメーター	型	必須	説明
method	dev_read_api: GET · dev_write_api: POST|PUT|PATCH|DELETE	いいえ	HTTP メソッド（ツールの標準メソッドがデフォルトです）
path	string	はい	絶対 API パス。例：/ephemeris/natal-chart
query	object	いいえ	クエリパラメーター
body	object	いいえ	GET 以外のリクエスト用 JSON ボディ
preset	full|simple	いいえ	query.preset に割り当てられる便利な指定
format	json|llm|llm_v2	いいえ	query.format に割り当てられる便利な指定（llm_v2 は llm に正規化されます）
output_mode	full|simple|llm|llm_v2	いいえ	レガシー互換フィールド

環境変数

変数	必須	説明
OPENEPHEMERIS_API_KEY	はい（サービスキー／JWT を使用する場合を除く）	Open Ephemeris の API キー
ASTROMCP_API_KEY	いいえ	OPENEPHEMERIS_API_KEY のレガシーエイリアス（フォールバックとして確認されます）
OPENEPHEMERIS_BACKEND_URL	いいえ	デフォルトは https://api.openephemeris.com
OPENEPHEMERIS_PROFILE	いいえ	デフォルトは dev
OPENEPHEMERIS_TOOLS	いいえ	core（デフォルト）では日常的に使うツールを厳選して公開し、full ではすべてのツールを公開します。ツールの公開範囲を参照してください
OPENEPHEMERIS_TELEMETRY	いいえ	匿名の利用状況報告を無効にするには、0／false／off を設定します。DO_NOT_TRACK=1 も使用できます。テレメトリーを参照してください
OPENEPHEMERIS_JWT	いいえ	ベアラートークン認証
OPENEPHEMERIS_DEV_ALLOWLIST_PATH	いいえ	許可リストのファイルパスを上書きします
MCP_USER_ID	いいえ	インスタンスごとのユーザー識別子

レガシーエイリアス（ASTROMCP_*、MERIDIAN_*）も引き続きサポートされています。

テレメトリー

このサーバーは、どのツールの保守に価値があり、どのツールに問題があるかを把握するため、匿名の利用状況を報告します。報告されるイベントは、セッション開始、ツール呼び出し、ツールエラーの3種類です。

送信される情報： ツール名、処理時間、エラーの有無、接続した MCP クライアント（例：Claude Desktop、Cursor）とそのバージョン、サーバーのバージョン、セッションの安定した ID（API キーの SHA-256 の一方向プレフィックス、または OAuth でサインインした場合のアカウント ID）。

送信されない情報： API キーやトークン、出生データ、日付、名前、座標、ツールの引数、ツールの結果。リクエストやレスポンスの本文は一切送信されません。

無効にするには — どちらの方法でも無効にできます。いずれも、データが送信される前に確認されます。

OPENEPHEMERIS_TELEMETRY=0
# or the cross-tool standard
DO_NOT_TRACK=1

ツールの公開範囲

デフォルトでは、サーバーはカタログ全体ではなく、日常的に使うツールを厳選したコアセットを公開します。ツールのリストが大きいとコンテキストを消費し、モデルによるツール選択の精度も低下するため、デフォルトは実際の会話に合わせて調整されています。各伝統に対応する対話型アプリを1つ、各ドメインの主要なデータツール、ジオコーディング、そして許可リストで制限された汎用プロキシが含まれます。

削除されたツールはありません。 公開範囲は tools/list のみに適用されるフィルターです。すべてのツールは登録されたままで、名前を指定すれば引き続き呼び出せます。使いたいツールがわかっていれば、リストに表示されていなくても呼び出して使用できます。

カタログ全体を公開するには：

OPENEPHEMERIS_TOOLS=full npx -y @openephemeris/mcp-server

リモート HTTP サーバーでは、コネクターの URL に ?profile=full を追加するか、X-OE-Tool-Surface: full を送信します。

https://mcp.openephemeris.com/mcp?profile=full

伝統別のツールセット

特定の伝統に取り組んでいる場合は、汎用のデフォルトを使うのではなく、その名前を指定してください。その伝統を網羅したツールセットを利用でき、コアセットには含まれないニッチなツールも含めて、コンテキストを大幅に節約できます。

OPENEPHEMERIS_TOOLS=hd npx -y @openephemeris/mcp-server        # Human Design
OPENEPHEMERIS_TOOLS=astrology,moon npx -y @openephemeris/mcp-server

https://mcp.openephemeris.com/mcp?profile=hd,bazi

ツールセット	対象範囲	ツール数	概算トークン数
astrology	ネイタル、トランジット、シナストリー、プログレス、リターン、リロケーション、品位、ミッドポイント、ロット、恒星、コンポジット	32	15,800
hd	ヒューマンデザインチャート、トランジット、コネクションチャート、ペンタ、ボディグラフ	14	7,800
bazi	四柱、十神、五行バランス、大運、相性	13	7,200
electional	タイミングウィンドウ、アングル通過、ステーション、時点分析	10	4,600
moon	月相、ボイド・オブ・コース、日食・月食	9	4,100
venus	スターポイント、月相、離角、ステーション	11	3,700
acg	アストロカートグラフィーのラインとヒット	7	3,700
vedic	ジョーティシュのラーシチャート	7	3,400
—	コア（デフォルト）	36	19,100
—	フル	70	34,600

どの選択にも、ジオコーディング（location_search、timezone_resolve）、account_usage、および許可リストによって制御されるプロキシが含まれます。そのため、出生地を常に解決でき、利用できない機能が残ることもありません。

カンマ区切りで指定してください。不明な名前は拒否されずに無視されるため、タイプミスをしても接続が使えなくなるのではなく、利用できる機能が少なくなります。core／fullと同様、これはtools/listをフィルタリングするだけで、すべてのツールを名前で呼び出せます。

重要な理由：ツールの定義は、実行のたびにモデルへ再送されます。astrology,moonはデフォルトと同じ数のツールを提示しながら、メッセージあたりのコストを約1,700トークン削減し、対象の伝統をより幅広くカバーします。

利用できる機能はセッションの初期化時に固定されます。このサーバーはtools.listChangedを通知しないため、切り替えるには再接続が必要です。dev_list_allowedは、利用できる機能にかかわらず、汎用プロキシから到達可能なすべての操作を列挙します。

貢献とサポート

• 結果に問題がありますか？ Issueを作成してください。ツール、入力内容、期待した結果を記載してください。
• 貢献したいですか？ CONTRIBUTING.mdをご覧ください。統合例や新しいスキルは、特に役立つ貢献です。
• セキュリティ上の問題を見つけましたか？ 非公開で報告してください。SECURITY.mdをご覧ください。
• ツールがタイムアウトしますか？ まずstatus.openephemeris.comを確認してください。

このツールのおかげで、LLMが自信満々に土星の位置をでっち上げずに済んだなら、⭐を付けてほかの人にも見つけてもらいましょう。

法的事項

このパッケージはMITライセンスの下でライセンスされています。ただし、このパッケージを使用してOpen Ephemeris APIにアクセスすることは、本サービスの利用にあたり、Open Ephemerisの利用規約が適用されます。このパッケージを使用することで、これらの規約に同意したものとみなされます。プライバシーポリシーと利用規定もご覧ください。

開発

サーバーのソースコードは非公開のモノレポで管理されています。このリポジトリには、公開ドキュメント、プラグイン、スキル、サンプルが含まれます。バグ報告や貢献を歓迎します。CONTRIBUTING.mdをご覧ください。

アーキテクチャ

┌─────────────────────────────────────────────────────────┐
│                    MCP Clients                          │
│  Smithery Gateway · Claude Web · ChatGPT · Remote apps  │
└──────────────────┬──────────────────────────────────────┘
                   │ Streamable HTTP (MCP 2025-11-25)
                   │ https://mcp.openephemeris.com/mcp
                   │
┌─────────────────────────────────────────────────────────┐
│          Cursor · Claude Desktop · Windsurf             │
└──────────────────┬──────────────────────────────────────┘
                   │ stdio JSON-RPC
                   │ npx @openephemeris/mcp-server
                   │
              ┌────▼────────────────────┐
              │  openephemeris-mcp      │
              │  Node.js MCP Server     │
              │  typed tools            │
              │  auth: Key > JWT        │
              └────────────┬────────────┘
                           │ HTTPS
                           ▼
              ┌────────────────────────┐
              │  Open Ephemeris API    │
              │  api.openephemeris.com │
              │  NASA JPL DE440        │
              │  1,100 years of data   │
              └────────────────────────┘

ランタイムスナップショット（生成）

config/dev-allowlist.json とライブツールレジストリから npm run sync:readme によって生成されます。

• 許可リストに登録された操作：123
• メソッド：GET=43、POST=80、PUT=0、PATCH=0、DELETE=0
• 登録済みツール（OPENEPHEMERIS_PROFILE=dev）：92
• 型付きツール：account_usage、acg_hits、acg_power_lines、auth_login、auth_logout、auth_status、bazi_annual_pillar、bazi_chart、bazi_compatibility、bazi_element_balance、bazi_luck_pillars、bazi_recalculate、bazi_ten_gods、bi_wheel_on_cross_aspect_click、bi_wheel_on_house_click、bi_wheel_on_planet_click、bi_wheel_recalculate、bi_wheel_synopsis、bodygraph_recalculate、chart_wheel_on_aspect_click、chart_wheel_on_house_click、chart_wheel_on_planet_click、chart_wheel_recalculate、chinese_bazi、electional_angle_crossings、electional_aspect_search、electional_moment_analysis、electional_station_tracker、ephemeris_angles_points、ephemeris_aspect_check、ephemeris_bi_wheel、ephemeris_chart_wheel、ephemeris_composite、ephemeris_composite_midpoint、ephemeris_dignities、ephemeris_electional、ephemeris_fixed_stars、ephemeris_hermetic_lots、ephemeris_house_cusps、ephemeris_lunar_return、ephemeris_midpoints、ephemeris_moon_phase、ephemeris_natal_batch、ephemeris_natal_chart、ephemeris_natal_transits、ephemeris_next_eclipse、ephemeris_next_lunar_phase、ephemeris_overlay、ephemeris_planet_position、ephemeris_planetary_return、ephemeris_progressed_chart、ephemeris_relocation、ephemeris_retrograde_status、ephemeris_solar_return、ephemeris_synastry、ephemeris_transits、explore_bazi_chart、explore_bi_wheel、explore_human_design、explore_human_design_connection、explore_human_design_transit、explore_moon_phase、explore_natal_chart、explore_transit_timeline、explore_vedic_chart、hd_on_center_click、hd_on_channel_click、hd_on_connection_channel_click、hd_on_gate_click、hd_on_planet_click、hd_on_transit_channel_click、hd_on_variable_click、hd_opposition、hd_planetary_return、human_design_bodygraph、human_design_chart、human_design_composite、human_design_penta、location_search、moon_phase_recalculate、timezone_resolve、vedic_chart、vedic_chart_recalculate、venus_eight_year_star、venus_elongations、venus_phase、venus_star_points、venus_star_points_conjunctions、venus_stations

許可リストのファミリー

ファミリー	操作数	例
acg	14	POST /acg/aspects、POST /acg/ccg
calendar	3	GET /calendar/astrology/cross-quarter、GET /calendar/astrology/lunar-standstill
catalogs	3	GET /catalogs/bodies、GET /catalogs/fixed-stars
chinese	9	POST /chinese/bazi、POST /chinese/bazi/annual-pillar
comparative	5	POST /comparative/composite、POST /comparative/composite/midpoint
eclipse	6	GET /eclipse/besselian-elements、GET /eclipse/lunar/global
electional	6	GET /electional/angle-crossings、GET /electional/aspect-search
ephemeris	38	GET /ephemeris/agro/calendar、GET /ephemeris/agro/daily
health	2	GET /health、GET /health/detailed
human-design	9	POST /human-design/chart、POST /human-design/composite
location	2	GET /location/autocomplete、GET /location/reverse
predictive	11	POST /predictive/primary-directions、POST /predictive/returns
root	1	GET /
tidal	1	GET /tidal/forcing
time	6	GET /time/delta-t、GET /time/equation-of-time
timezone	3	GET /timezone/coverage、POST /timezone/lookup
vedic	1	POST /vedic/chart
visualization	3	POST /visualization/bi-wheel、POST /visualization/bodygraph

AI エージェントに Open Ephemeris が必要な理由

ほとんどの LLM（Claude や ChatGPT など）は、天文計算（三角関数、ユリウス日への変換、惑星の検索）を非常に苦手としています。Open Ephemeris は、安全なリモートの計算エンジンとして機能します。

LLM と Open Ephemeris MCP サーバーを組み合わせることで、エージェントは次の機能をすぐに利用できます。

• ハルシネーションのない座標：1,100 年分の天文データにわたる、NASA JPL DE440 によるサブ秒角精度の直接計算。
• LLM 向けに最適化されたトークン（format=llm）：標準の 25,000 トークンの JSON チャート応答を最小限のテキストブロックに圧縮し、エンドポイントに応じて推論コストを 50～73% 削減します。
• すぐに使える占星術レイヤー：Astrocartography の geoJSON ライン、Hermetic Lots、Fixed Stars、複雑な Human Design マトリックス生成を標準でサポートしています。