cosine-astro-mcp

cosine-astro-mcp

西洋占星術（トロピカル方式）の計算を行うMCPサーバーです。ネイタルチャート、トランジット、シナストリー、水星逆行、年次プロフェクション、月相に対応しています。

言語モデルは、特定の日付に惑星がどこにあったかを正確に割り出すのが苦手で、推測しがちです。このサーバーは、astronomy-engineの天体暦を使ってオフラインで位置を計算し、コンパクトなテキスト要約と完全なJSONデータの両方をモデルに渡します。APIキーもネットワークへの接続もアカウントも不要です。

COSINE 余弦が制作しました — cosineastro.comは、AIによるリーディングを提供する出生図サイトです。これは同サイトで使われているチャートエンジンと同じものを、MCPサーバーとして公開したものです。

繁体字中国語の説明

インストール

Node.js 20以降が必要です。

Claude Code

claude mcp add cosine-astro -- npx -y cosine-astro-mcp

すべてのプロジェクトで利用できるようにするには、--scope userを追加してください。

Claude Desktop — claude_desktop_config.jsonを編集します（Settings → Developer → Edit Config）：

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

Cursor — ~/.cursor/mcp.json（グローバル）または.cursor/mcp.json（プロジェクトごと）：

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

stdioに対応した他のMCPクライアントも同様に使用できます。コマンドはnpx -y cosine-astro-mcpです。

ツール

すべてのツールは読み取り専用で、同じ入力に対して決定論的な結果を返します（日付がデフォルトで「現在」になる場合を除きます）。

ツール	返される内容
natal_chart	10天体（サイン、度数、ハウス、逆行、日ごとの運動）、アセンダントとミッドヘブン、12ハウスのカスプ、オーブおよび接近中／分離中の情報を含む主要アスペクト、各要素とモダリティのバランスおよびそれぞれの優勢要素。
transits	指定日時（デフォルト：現在）の惑星位置、およびネイタルチャートが与えられた場合は、オーブ（デフォルト2°）以内でネイタルの惑星、アセンダント、ミッドヘブンに形成するアスペクトと、各トランジット天体が位置するネイタルハウス。
synastry	2つのチャート間のクロスアスペクト（惑星とアセンダント）、それぞれの人物の惑星が相手のどのハウスに入るか、コンジャンクション、調和的なアスペクト、チャレンジングなアスペクトの簡潔な集計。
mercury_retrograde	日付範囲と重なる水星逆行期間：プレシャドウ開始、逆行開始、順行開始、ポストシャドウ終了（約1分単位）と、両方の留の度数。
annual_profection	年齢または日付に対する、プロフェクションのハウスとサイン（アセンダントからのホールサイン方式）、年の支配星とそのネイタルでの位置、プロフェクション年の期間。
moon_phase	月相名、照らされている割合、太陽と月の角度、新月からの日数、月と太陽のサイン、次の新月、上弦、満月、下弦。

出生データ

natal_chart、annual_profection、および transits と synastry の natal／person_a／person_b オブジェクトには、次の項目を指定します。

フィールド	型	備考
date	"YYYY-MM-DD"	必須です。現地の暦日を指定します。対象年は1800～2200年です。
time	"HH:MM"	現地時刻を24時間表記で指定します。不明な場合は省略してください。その場合、惑星の位置は現地時間の正午で算出され、アセンダント、ミッドヘブン、ハウスは算出されません。また、その日の月の位置の範囲が報告されます。
timezone	IANAゾーン	例："Asia/Shanghai"、"America/New_York"。過去の夏時間も適用されます（中国の1986～1991年の夏時間を含みます）。
latitude、longitude	度	北緯と東経を正の値で指定します。アセンダント、ミッドヘブン、ハウスの算出に必要です。
city	文字列	約110の主要都市を収録した組み込みテーブルから選ぶ省略指定です（英語名または中国語名）。明示的に指定した座標とタイムゾーンが優先されます。ジオコーディングサービスはありません。その他の場所では、座標を指定してください。
house_system	"placidus" | "whole_sign"	デフォルトはプラシーダスです。プラシーダスで解が得られない極圏内では、ホールサインハウスが使われ、その旨が出力に記載されます。

その他のパラメーター：transits は date、time、timezone、natal、max_orb を受け取ります。mercury_retrograde は start_date、end_date、timezone を受け取ります。annual_profection は age または on_date を受け取ります。moon_phase は date、time、timezone を受け取ります。各ツールのJSONスキーマには、各フィールドの説明が含まれています。

出力

各呼び出しでは、2つのテキストブロックと structuredContent が返されます。

1. モデル向けに書かれた簡潔な要約。位置は計算結果であり、解釈は予測ではなく内省のために提示するよう促す短い注記で締めくくられます。
2. 同じデータをJSON形式で示したもの（structuredContent にも含まれます）。

例（natal_chart、1995-05-12 08:30、上海）：

Natal chart: 1995-05-12 08:30 Asia/Shanghai (UTC+08:00) · 31.23°N 121.47°E · Placidus houses
Sun 20°51′ Taurus (H11); Moon 11°41′ Libra (H4); Mercury 12°17′ Gemini (H12); Venus 24°00′ Aries (H10); Mars 24°13′ Leo (H2); Jupiter 13°00′ Sagittarius (H6) R; ...
ASC 12°04′ Cancer · MC 28°08′ Pisces
Aspects: Venus trine Mars 0.2° a; Moon trine Mercury 0.6° a; Mercury opposition Jupiter 0.7° a; ...
Balance: fire 20%, earth 20%, air 27%, water 33% → water; cardinal 40%, fixed 33%, mutable 27% → cardinal

慣例

• 位置は、地心視黄道座標による、その日のトロピカル黄経です。
• チャート内のアスペクト：コンジャンクションとオポジションは8°、スクエアとトラインは6°、セクスタイルは4°です。2つのチャート間（シナストリー）：それぞれ6°、5°、5°、3°です。トランジット：すべてのアスペクトに同じオーブを適用し、デフォルトは2°です。
• エレメント／モダリティのバランス：太陽、月、アセンダントは各2ポイント、水星から冥王星までの各天体とミッドヘブンはそれぞれ1ポイントです。同点の場合は、太陽のエレメント、次に月のエレメント、次にアセンダントのエレメントを優先します。
• プロフェクションでは、アセンダントから数えて各サインを1年とします（出生時刻が不明な場合は太陽のサインから数えます）。年の支配星は伝統的な支配星とし、現代の共同支配星（冥王星、天王星、海王星）が異なる場合はその旨を記載します。
• シャドウ期間：プレシャドウは、水星が後に順行へ転じる度数に初めて到達した時点で始まります。ポストシャドウは、水星が逆行へ転じた度数を通過して戻った時点で終わります。

含まれないもの：小惑星、月のノード、リリス、キロン、サイデリアル方式の黄道十二宮、プラシーダスとホールサイン以外のハウスシステム、解釈文。

精度

テストスイートでは、1900年から2050年までの55件の参照チャートを用いて、エンジンと Swiss Ephemeris（2.10.03、pyswisseph経由）を比較しています。対象には北半球と南半球、東経と西経、赤道、高緯度（北極圏内を含む）、過去の夏時間、出生時刻不明のケースが含まれます。すべての惑星の黄経、アセンダント、ミッドヘブン、プラシーダスのカスプは、参照値との差が 1′以内です（最大差：惑星0.34′、アセンダント／ミッドヘブン0.20′、カスプ0.21′）。すべてのUTC換算も一致します。角度の計算では、Swiss Ephemerisと同様に、章動を含む真黄道傾斜角を使用しています。このリポジトリに含まれているのは参照値のみです（tests/fixtures/reference-charts.json）。Swiss Ephemerisのコードは使用も配布もしていません。

知っておいていただきたいこと：

• タイムゾーンは、Node.jsに組み込まれているIANAデータベースを使用します。地域が標準時を採用する前の日付については、データベースは地方平均時を使用します。参照元が別の規則を使用していた場合は、希望するタイムゾーンを指定してください（たとえば、固定のUTC+8には "Etc/GMT-8"）。
• アセンダントは4分ごとに約1度移動します。そのため、チャートの精度は出生時刻の精度に左右されます。
• 組み込みの都市座標は、市の中心部を約0.01°の精度で示しています。
• 逆行の留は、約1分の精度で特定されます。

COSINEの手法と精度に関する説明：cosineastro.com/en/accuracy。

解釈について

天体の位置は天文学に基づくものです。それが何を意味するかは、測定ではなく、解釈の伝統に属するものです。サーバーはすべての結果でそのことを伝え、モデルには、リーディングを予言やアドバイスではなく、内省のためのきっかけとして提示するよう促します。

開発

npm install
npm test          # reference charts + every tool through an MCP client
npm run build
npm run smoke     # starts dist/index.js over stdio and calls each tool
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

クレジットとライセンス

MIT。チャートエンジンはCOSINEから移植され、Don Crossによるastronomy-engine（MIT）を使用しています。テストの参照値はAstrodienstのSwiss Ephemerisを使って生成しました（数値の生成にのみ使用しており、このパッケージには含まれていません）。

COSINE制作 — https://www.cosineastro.com · 無料の出生チャート · 精度

---

繁体字中国語

cosine-astro-mcp は、西洋占星術（トロピカル方式）の計算を提供するMCPサーバーです。本命チャート、トランジット、シナストリー、水星逆行、年次プロフェクション、月相に対応しています。

大規模言語モデルが自力で惑星の位置を計算すると、多くの場合、正確ではありません。このサーバーは代わりにastronomy-engineの天体暦を使ってローカルでオフライン計算を行い、モデルが読み取れる簡潔なテキスト要約と、完全なJSONデータを返します。APIキーは不要で、ネットワークにも接続しません。

COSINE 余弦（cosineastro.com）が制作しており、ウェブサイトと同じチャートエンジンを使用しています。

インストール

Node.js 20以上が必要です。

• Claude Code：claude mcp add cosine-astro -- npx -y cosine-astro-mcp
• Claude Desktop／Cursor：設定ファイルのmcpServersに"cosine-astro": { "command": "npx", "args": ["-y", "cosine-astro-mcp"] }を追加してください（完全な例は上記の英語の説明を参照）。

ツール

ツール	内容
natal_chart	本命チャート：10天体の星座、度数、ハウス、逆行の有無、アセンダント、ミッドヘブン、12ハウスのカスプ（デフォルトはプラシーダス方式。北極圏内では全星座方式に切り替わり、その旨が明記されます）、主要なアスペクトとオーブ、接近中／分離中の別、エレメントとモダリティの分布および優勢。
transits	指定した時刻（デフォルトは現在）の惑星の位置。本命チャートを指定すると、トランジットの惑星と本命の惑星、アセンダント、ミッドヘブンとのアスペクト（デフォルトのオーブは2°）と、トランジットの惑星が入る本命ハウスを一覧表示します。
synastry	シナストリー：双方の惑星（アセンダントを含む）間のアスペクト、各自の惑星が相手のどのハウスに入るか、簡単なアスペクト統計（相性スコアではありません）。
mercury_retrograde	指定した日付範囲内の水星逆行：逆行前の影響期間の開始、逆行への転換の留、順行への転換の留、逆行後の影響期間の終了（約1分の精度）、および2回の留の度数。
annual_profection	年齢または日付から年次プロフェクションを計算します。プロフェクションのハウスと星座（アセンダントの星座からホールサイン方式で計算します。出生時刻が不明の場合は太陽星座から計算します）、年主星とその本命での位置、そのプロフェクション年の開始日と終了日を返します。
moon_phase	月相の名称、照明率、太陽と月の角距離、月齢、および次の新月、上弦、満月、下弦。

出生データ：date（YYYY-MM-DD、必須）、time（HH:MM。不明な場合は省略すると、アセンダント、ミッドヘブン、ハウスは返されません）、timezone（Asia/TaipeiなどのIANAタイムゾーン。過去の夏時間も自動適用されます）、latitude／longitude（北緯と東経を正とします）。または、組み込みの約110都市（中国語名・英語名のいずれも可、簡体字・繁体字のいずれも可）からcityで選択できます。ジオコーディングサービスは呼び出しません。その他の場所については、緯度と経度を直接指定してください。

精度

Swiss Ephemeris（2.10.03、pyswisseph）で計算した55件の参照チャート（1900～2050年。南北半球、東経と西経、赤道、高緯度および北極圏内、過去の夏時間、出生時刻不明のケースを含む）と照合してテストしています。すべての惑星の黄経、アセンダント、ミッドヘブン、プラシーダスのカスプの誤差は 1分角以内です（最大差：惑星0.34′、アセンダント／ミッドヘブン0.20′、カスプ0.21′）。UTC換算もすべて一致します。アセンダントとミッドヘブンには、章動を含む真黄道傾斜角を使用しており、Swiss Ephemerisと同じ方式です。このプロジェクトには参照値のみを収録しており、Swiss Ephemerisのコードは含まず、配布もしていません。精度について詳しくはcosineastro.com/en/accuracyをご覧ください。

解釈について

惑星の位置は天文学的な計算結果です。それが何を意味するかは、測定結果ではなく、占星術の解釈の伝統に属するものです。返される結果には毎回、解釈は予言やアドバイスではなく、自己内省のための参考として扱うよう促す注意書きが付いています。

授權

MIT。星盤引擎移植自 COSINE，使用 Don Cross 的 astronomy-engine（MIT）。

由 COSINE 製作 — https://www.cosineastro.com · 免費排本命盤