w8s-astro-mcp

w8s-astro-mcp

個人向け占星術 MCP サーバー — 照会可能な SQLite データベースを基盤とした、出生図、トランジット、予測、相性図。

⚠ v0.12 以前からアップグレードしますか？保存済みのチャートは、誤ったタイムゾーンで計算されています。 出生時刻、イベント時刻、選日用の時刻が現地時刻ではなく UT として扱われていたため、アセンダント、MC、ハウス、月の位置に誤差があります。惑星のサインはほとんどの場合変わりません。変更内容を確認するには w8s-astro-recalculate --all を実行し、その後 --apply を追加してください。 詳細

特長

• 🔭 スイス暦による高精度計算 — pysweph による惑星の位置計算。高精度ファイルのダウンロードも任意で利用できます
• 🗂️ 複数プロフィールに対応 — 自分や家族、友人のチャートを管理できます
• 📜 履歴を永続化 — トランジットの検索はすべて SQLite に自動記録され、日付、惑星、サインで照会できます
• 🧭 トランジットの読み解き — 今日の空模様を出生図と比較し、接近・分離の方向と正確になる時刻の推定を確認できます。JSON 出力も任意で利用できます
• 🎛️ 配置ダイヤル — 惑星、サイン、ハウスがそれぞれ単独で、また組み合わさってどのような意味を持つかを、自分の配置を使って学べるインタラクティブなページです
• 🔗 相性図 — 2 人以上の任意のグループのコンポジットチャートとデイヴィソンチャートを作成できます。今日の空模様を、任意のチャートのハウスシステムに配置できます
• 🗓️ イベント・選日ツール — 任意の時刻のチャートを作成し、吉時の期間を検索できます

クイックスタート

1. uv がまだインストールされていない場合はインストールします — お使いのプラットフォーム向けの手順は、uv のインストールガイドをご覧ください。

2. Claude Desktop の設定に追加します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "w8s-astro-mcp": {
      "command": "uvx",
      "args": ["w8s-astro-mcp"]
    }
  }
}

3. Claude Desktop を再起動し、プロフィールを作成します：

「自分の占星術プロフィールを作成してください。名前は［名前］、出生日時は［YYYY-MM-DD］の［HH:MM］、出生地は［都市、州］です。」

4. 自分を所有者に設定します：

「自分を所有者プロフィールに設定してください。」

これにより、サーバーにあなたが誰であるかを伝えます。ほかの人について尋ねない限り、すべてのツールはデフォルトであなたのチャートを使用します。データはすべて ~/.w8s-astro-mcp/astro.db（macOS/Linux）または %USERPROFILE%\.w8s-astro-mcp\astro.db（Windows）に保存されます。

インストール

推奨：uvx（インストール不要）

uvx は PyPI からパッケージを取得し、分離された環境で自動的に実行します。上記の設定を使用してください。

別の方法：pip

pip install w8s-astro-mcp

その後、Claude Desktop の設定で "command": "w8s-astro-mcp"（args は不要）を使用してください。

以前のバージョンからのアップグレード

v0.12 より前の既存データベースがある場合は、移行スクリプトを一度実行してください。

python scripts/migrate_owner_profile.py

これにより、内部の current_profile_id 列が owner_profile_id に変更されます。複数回実行しても安全です。

v0.14.0 へのアップグレード — 保存済みのチャートを再計算してください。 以前のバージョンでは、現地の出生時刻を UT として扱っていたため、保存済みのすべての出生図でアセンダント、MC、ハウス、月の位置が誤っています。アップグレード後に一度、次のコマンドを実行して修正してください。

w8s-astro-recalculate --all            # dry run: shows exactly what would change
w8s-astro-recalculate --all --apply    # backs up the database first, then recalculates
# with uvx: uvx --from w8s-astro-mcp w8s-astro-recalculate --all

保存済みのイベントチャートも含めるには --events を追加します。1 件だけ再計算するには --event LABEL を追加します（複数件の場合は繰り返し指定します）。複数回実行しても安全です。再計算が必要な保存済みチャートがあれば、アップグレード後に AI アシスタントがこの操作について知らせます。このリリースでの compare_charts の変更は後方互換の追加変更です。既存の出力はそのままに、アスペクトごとに 1 行を追加します（このテキストを解析している場合は、CHANGELOG を参照してください）。通知を希望しない場合は、通知を閉じるよう指示してください。時刻について：出生時刻、イベント時刻、イレクショナルの日付は現地時刻（場所のタイムゾーンを使って変換されます）です。get_transits、find_house_placements、compare_charts に渡す time はUTです。

新規インストールで AttributeError: 'Server' object has no attribute 'list_tools' が発生する場合： v0.12.1 以降にアップグレードしてください（uvx --refresh w8s-astro-mcp、または pip install -U w8s-astro-mcp）。以前のバージョンでは、使用する MCP SDK のバージョンを制限していなかったため、新規インストールでこのサーバーがまだサポートしていない SDK 2.x がインストールされていました。

必要条件

• Python 3.10+
• uv（uvx を使う場合）または pip
• Claude Desktop（または MCP 互換のクライアント）

使用例

始めましょう：

「私の占星術プロフィールを作成してください。名前は [Name]、生年月日は [YYYY-MM-DD]、出生時刻は [HH:MM]、出生地は [City, State] です。」

「私の出生図を見せてください。」

日々の実践：

「今日のトランジットを教えてください。」

「水星が最後に逆行したのはいつですか？」

「今後 90 日間に起こる主なトランジットを教えてください。」

「今日の私のチャートに対するトランジットのうち、強まっているものと弱まっているものはどれですか？」

天体の配置の意味を知る：

「火星が牡牛座の第 3 ハウスにある意味がわかるように、配置ダイヤルのページを作ってください。」（HTML ファイルがダウンロードフォルダーに保存されます。ブラウザーで開いてください）

ほかのプロフィール：

「Liz の出生図を見せてください。」

「今日の彼女のトランジットを教えてください。」

「私のチャートと Liz のチャートを比較してください。」（シナストリー）

ハウスの配置：

「今日の惑星は、私の出生図のどのハウスにありますか？」

「今日の空模様は、私たちのコンポジットチャートのどこに現れますか？」

人間関係：

「生年月日が [YYYY-MM-DD]、出生時刻が [HH:MM]、出生地が [City, State] のパートナーのプロフィールを作成してください。」

「『Us』というコネクションを作成して、私たちのシナストリーを見せてください。」

「私たちのデイヴィソンチャートを計算してください。」

イベントと計画：

「結婚した瞬間のチャートを作成してください。日時は [date] の [time]、場所は [city] です。」

「来月、契約に署名するのに縁起の良い時刻を探してください。月はボイドではなく、水星は順行していること。」

履歴と調査：

「木星が最後に牡牛座にあったのはいつですか？」

「先月の私のトランジット照会をすべて見せてください。」

ドキュメント

ドキュメント	内容
docs/ARCHITECTURE.md	ディレクトリー構成、全ツール一覧、データフロー、設計上の決定事項
docs/DATABASE_SCHEMA.md	ERD 全体、すべてのモデル、SQL クエリの例
docs/ROADMAP.md	フェーズの履歴と計画中の作業
docs/TESTING_MCP.md	Claude Desktop の設定方法とサーバーのスモークテスト方法

貢献と開発

開発ワークフロー、テストコマンド、ブランチ戦略、リリースチェックリストについては、AGENTS.md を参照してください。

質問とバグ

GitHub で issue を作成してください。

ライセンス

AGPL-3.0