Astroway Mcp

Name: Astroway Mcp
Author: astroway

ローカル

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

リポジトリ

Astroway Mcp について

Astroway Mcpは、AstroWay Calculation APIの占星術、タロット、数秘術、Human DesignのエンドポイントをAIエージェントに提供します。ツール一覧はAPIマニフェストからビルド時に生成され、カテゴリ別の絞り込みやオンデマンド検索に対応します。

主な機能

01ネイタルチャート、シナストリー、トランジットの計算
02ヴェーダ占星術と複数のダシャー方式に対応
03タロット、数秘術、Human Designのツール
04カテゴリ別のツール登録フィルタリング
05必要に応じたツールの検索と呼び出し

活用シーン

01ネイタルチャートや惑星トランジットの計算
022つの占星術チャートの比較
03タロットスプレッドのリーディング生成
04必要な占星術APIツールの検索

MCP 対応

AstroWay Calculation APIのエンドポイントをツールとして登録し、対応クライアントから呼び出せるMCPサーバーです。全ツール、カテゴリ別の選択、または検索モードを利用できます。

#astrology #mcp #vedic #tarot #numerology #human-design #swiss-ephemeris #natal-chart #synastry #ai

設定

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

mcp.json · 共通設定

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": [
        "-y",
        "@astroway/mcp"
      ],
      "env": {
        "ASTROWAY_API_KEY": "<ASTROWAY_API_KEY>"
      }
    }
  }
}

起動コマンドnpx -y @astroway/mcp

設定が必要な環境変数

ASTROWAY_API_KEYシークレット

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

パッケージ

npm@astroway/mcpstdio

ツール

735

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

このツールにパラメーターはありません。

詳細

@astroway/mcp

MCP（Model Context Protocol）サーバーです。AstroWay Calculation API のすべてのエンドポイントを、Claude Desktop、Cursor、およびMCP互換のあらゆるAIエージェント向けのツールとして公開します。

ネイタルチャート、シナストリー、トランジット、ヴェーダ占星術のダシャー（ヴィムショッタリ、ヨーギニー、アシュトッタリ、カーラチャクラ）、16のヴァルガ、タロット（ライダー・ウェイト／マルセイユ／ルノルマン）、数秘術（5種類の方式）、ヒューマンデザイン、AIホロスコープなど、すべてをMCPツールとして提供し、エージェントが直接呼び出せます。

ツールはビルド時に稼働中のAPIマニフェストから自動生成されるため、各リリースには本番環境に存在するすべてのエンドポイントが含まれます。ツール一覧を手動で管理する必要はありません。

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

Claude Desktopを再起動します。チャット入力欄の下部にあるMCPインジケーターに、astroway サーバーが表示されます。

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

同じ npx @astroway/mcp コマンドが、すべてのMCP互換クライアントで動作します。このブロックをクライアントのMCP設定ファイルに追加します（場所はクライアントによって異なります）。

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

設定ファイルの場所：

クライアント	設定パス
Cline（VS Code）	ワークスペースのルートにある `.cline/mcp.json`
Continue	`~/.continue/config.json`（`mcpServers` の下）
Windsurf	`~/.codeium/windsurf/mcp_config.json`
GitHub Copilot Chat（VS Code）	設定でプレビューを有効にしてから、ワークスペース内の `mcp.json`
VS Code MCP extension	`~/.vscode/mcp.json`

その他のMCPクライアント

stdioサーバーとして実行します。

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

プライバシー

このMCPサーバーが外部に通信することはありません。テレメトリー、分析、使用状況の報告はなく、オプトイン／オプトアウトの切り替えを管理する必要もありません。サーバーから発生するネットワーク通信は、リクエストされたAstroWay API呼び出しのみで、お使いのマシンから https://api.astroway.info/v1 に直接送信されます。

送信リクエストには、AstroWayのバックエンドが独自のログでMCPトラフィックと通常のHTTPトラフィックを区別できるよう、識別用ヘッダーが2つ含まれます。

User-Agent: astroway-mcp/<version> (Node/<node-version>)
X-Astroway-Channel: mcp

どちらのヘッダーにもセッションID、マシンのフィンガープリント、個人情報は含まれません。標準的なHTTPの User-Agent の仕様に沿ったもので、CLIツールはすでに同様の情報を送信しています。

サブセットの登録（上級者向け）

カタログの一部だけを使用する場合は、サブセットを登録してLLMのコンテキストウィンドウを軽くできます。

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

一般的なグループ：western、vedic、tarot、numerology、hd（ヒューマンデザイン）、relational（シナストリー／コンポジット／ダヴィソン）、prognostics（トランジット／プログレッション／リターン）、aspects、horary、geo、chinese、bazi、mayan、iching、runes、geomancy。全ツールを確認するには npx @astroway/mcp --list-tools を実行してください。起動時の filters: … フィールドに適用されたフィルターが表示されます。

ASTROWAY_READONLY=1 を設定すると、内部でLLMを呼び出す3つのグループ（ai、horoscope、reports）が除外されます。テキスト生成にクレジットを消費せず、純粋に決定論的なチャート計算を行いたい場合に便利です。

Discovery（軽量）モード

エージェントがフルカタログでコンテキストまたはツール数の上限に達した場合は、ASTROWAY_DISCOVERY_MODE=1 を設定してください。サーバーは 600 以上のツールを最初から登録する代わりに、次の 2 つのメタツールのみを公開します。

astroway_find_tool(query, limit?)：カタログ全体をキーワード検索し、最も一致するツールを、1 行の説明と入力パラメーター名とともに返します。
astroway_call_tool(name, arguments?)：検索で見つかった任意のツールを実行します。

エージェントは必要に応じて適切なツールを見つけてから呼び出し、2 つのツールだけでカタログ全体を利用できます。

トレードオフ：astroway_call_tool 経由で実行したツールは、結果をテキストのみで返します。実行時にディスパッチされる呼び出しでは、呼び出しごとの outputSchema を宣言できないため、直接登録されたツールが提供する検証済みの structuredContent を返すことはできません。型付きの構造化出力が必要な場合は ASTROWAY_DISCOVERY_MODE を未設定（デフォルト）のままにし、ツール数の制限を優先する場合は設定してください。Discovery モードを有効にすると、ASTROWAY_TOOL_GROUPS / ASTROWAY_READONLY よりも優先されます。

安定性

カタログはセッション中固定されています。 カタログ全体（ツール、プロンプト、リソース）は公開済み npm パッケージに組み込まれており、実行中に変更されることはありません。（MCP の listChanged 機能は SDK によって通知されますが、このビルドでは */list_changed 通知は一切送信されません。クライアントが最初の tools/list の後にカタログをキャッシュする場合、接続中はその内容が変わらないため正しい状態が維持されます。）
ツール識別子はメジャーバージョン内で安定しています。 astroway_<group>_<tool> として公開された名前が、同じ v0.x のマイナー内で非推奨の注記を CHANGELOG.md に記載せずに変更または削除されることはありません。メジャーバージョンが上がる場合（v1 → v2）は、互換性を破る変更を告知し、従来の回避策である MCP_FLAT_TOOLS=1 を使えば 1 マイナーバージョン分は移行できます。
ツールの入力形式はマイナーバージョン内で安定しています。 制約の厳格化（正規表現、範囲、列挙値）はパッチで提供されます。必須フィールドの追加にはマイナーバージョンの更新が必要です。
再インストールしてカタログを更新します。 npm i -g @astroway/mcp@latest（または、クライアント設定ですでに使用している npx -y @astroway/mcp 形式）を実行すると、次回起動時に最新のセットが取得されます。

インストールを確認する

MCP クライアントを再起動した後：

MCP インジケーターを開きます（Claude Desktop ではチャット入力欄の下部、Cursor ではステータスバーにあります）。
astroway がアクティブなサーバーとして表示されていることを確認します。
ホバーまたはクリックすると、登録されているツール、プロンプト、リソースの数がバッジに表示されます。npx @astroway/mcp --list-tools を実行すると、インストール済みバージョンのツール一覧がすべて表示されます。
初回のコールドスタートには 2〜3 秒かかります（Node と api.astroway.info への TLS ハンドシェイク）。
任意のターミナルで簡単に確認できます。npx @astroway/mcp --version はパッケージのバージョンを表示し、npx @astroway/mcp --list-tools synastry は一致するツールを表示します。

サーバーが表示されない場合は、上記の env ブロックに LOG_LEVEL=debug を設定して再起動してください。起動ログと起動時のエラーは、クライアントの MCP デバッグパネルに表示されます。

API キーを取得する

https://api.astroway.info/dashboard/sign-up で登録すると、毎月 10 000 クレジットを無料で利用できます。カードの登録は不要です。リクエストごとの料金はエンドポイントによって 5〜500 クレジットです（料金を参照）。

有料プランを使わずにローカルでテストする場合は、無料で決定論的なレスポンスを返すサンドボックスキー（aw_test_...）を使用してください。

提供される内容

以下に例を示す、ツールのカテゴリーです。npx @astroway/mcp を一度実行し、エージェントに 「list astroway tools」 と尋ねると、最新の全ツール一覧を確認できます（パッケージはリリースごとに API と自動同期されます）。

カテゴリー	例
コア	出生図、惑星の位置、ドラコニック、ハーモニクス
比較	シナストリー、コンポジット、ダビソン、異なるシステム間の相性
予測	トランジット、二次進行図、ソーラー／ルナーリターン、トランジットカレンダー
特殊チャート	ヘリオセントリック、サイデリアル、食の検索
アスペクトとポイント	アスペクト表、アンティスキア、中間点、アラビックパーツ、恒星
カレンダーと周期	逆行期間、イングレス、月相、惑星時間
品位とレセプション	本質的品位、アルムーテン、ヒューレーグ、ディスポジター
ホラリー	ホラリーチャート、ボイド・オブ・コースの月、ヴィア・コンブスタ
ヒューマンデザイン	フルチャート、トランジット、ペンタ、ドリームレイヴ、ホロジェネティックプロファイル
アストロジオグラフィー	アストロカートグラフィー、ローカルスペース、リロケーションチャート
ヴェーダ占星術	16 のヴァルガ、パンチャンガ、シャドバラ、4 つのダシャーシステム × 5 レベル（ヴィムショッタリ／ヨーギニー／アシュトッタリ／カーラチャクラ）、ヨーガ、ドーシャ、相性、ムフルタ
タロット	ライダー・ウェイト・スミス、マルセイユ、ルノルマンのデッキ。スプレッドとカード検索
数秘術	ピタゴラス式、カルデア式、カバラ式、ヴェーダ式、運命のマトリックス
秘教	易経、サビアンシンボル、フォーチュンダイス、色と宝石の対応関係
リファレンス	サイン、惑星、ハウス、アスペクト、ナクシャトラ、ヘレニズムのロット、出生図のテキスト（編集済みの解釈文。AI は使用しません）
AI による解釈	出生図、シナストリー、トランジット。4 つのペルソナによるチャートに基づいたチャット。21 言語
ホロスコープ	デイリー、ウィークリー、マンスリー、相性（星座に基づく）

プロンプトの例

サーバーに接続したら、Claude Desktop で次のプロンプトを試してください。

出生図

1990-03-15 14:30 にウクライナの Kyiv（50.45N 30.52E、UTC+2）で生まれた私の出生図を計算してください。太陽、月、アセンダント、およびタイトなアスペクトがあれば特定してください。

シナストリー

2 人のチャートを比較してください。A さんは 1988-06-10 09:15 に London（51.51N -0.13E UTC+1）生まれ、B さんは 1991-11-22 22:40 に Berlin（52.52N 13.40E UTC+1）生まれです。最も強いクロスアスペクトは何ですか？

ヴェーダ占星術のヴィムショッタリ・ダシャー

1985-07-22 06:45 に Mumbai（19.07N 72.87E UTC+5.5）で生まれた人のヴィムショッタリ・マハーダシャーを実行してください。現在（2026 年 5 月）はどの惑星の期間ですか？

トランジット予測

2027-01-01 に、どのような主要な外惑星トランジットが私の出生図に影響しますか？出生情報：1990-03-15 14:30、Kyiv（50.45 30.52 UTC+2）。

タロットリーディング

「新しい仕事を引き受けるべきか？」という質問について、ライダー・ウェイトのデッキから過去・現在・未来の 3 枚引きをしてください。再現性のためにシード 42 を使用してください。

ヒューマンデザイン

1990-03-15 14:30 に Kyiv（50.45 30.52 UTC+2）で生まれた人のヒューマンデザインのタイプ、ストラテジー、オーソリティは何ですか？定義されたセンターとインカネーションクロスを列挙してください。

チャートに基づいたチャット

astroway_mcp_ai_chat を使って、私の土星の配置が何を意味するか尋ねてください。1990-03-15 14:30、Kyiv（50.45 30.52 UTC+2）生まれです。回答では、根拠としたハウスとアスペクトのオーブを示してください。

設定

環境変数	デフォルト	説明
`ASTROWAY_API_KEY`	(必須)	API キーです。ライブ環境：`aw_live_...`。サンドボックス：`aw_test_...`。
`ASTROWAY_BASE_URL`	`https://api.astroway.info/v1`	セルフホスト環境／ステージング環境で使用する URL を上書きします。

ツールの生成方法

ビルド時のスクリプトが本番 API から正規のエンドポイントマニフェストを読み込み、各エンドポイントを入力形式（chart、twoChart、chartTarget、horoscopeSign、year、date、generic）で分類し、型付きのツール定義を生成します。続いて MCP サーバーが、適切な Zod 入力スキーマを用いて各エントリーを MCP Tool として登録します。

API に新しいエンドポイントが追加されると、次回の MCP リリースで自動的に利用可能になります。手動でツール定義を同期する必要はありません。

トラブルシューティング

Claude Desktop にサーバーが表示されません。 チャット入力欄の下部に MCP インジケーター（スライダーアイコン）があるか確認してください。クリックすると、登録済みサーバーと起動エラーを確認できます。astroway が見つからない場合は、ターミナルで npx @astroway/mcp コマンドを手動で実行してください。起動エラーは標準エラー出力に表示されます。

ツールが Error 401 を返します。 API キーが未設定、無効、または取り消されています。https://api.astroway.info/dashboard/keys で新しいキーを生成してください。

ツールが Error 402 を返します。 無料プランのクレジットが不足しています。https://api.astroway.info/pricing/ でアップグレードするか、月次リセットをお待ちください。

ツールがフィールドの検証エラーを伴う Error 422 を返します。 LLM が API で受け付けられない本文を渡しました。ツールの説明に記載されている本文の例を使って再試行するよう Claude に依頼するか、サンドボックスキー（aw_test_...）を使用してクレジットを消費せずにデバッグしてください。

リポジトリの構成

このリポジトリは @astroway/mcp の公開ショーケースで、README、CHANGELOG、LICENSE、インストール手順を含みます。実行可能なコードは公開されている npm パッケージそのものです。npm install @astroway/mcp でインストールするか、npx @astroway/mcp で実行してください。

ソースはプライベートな AstroWay モノレポで管理されています。これにより、ビルド時のジェネレーターが隣接する API ワークスペースから正規のエンドポイントマニフェストを読み込めます。生成されたパッケージは MIT ライセンスのオープンソースで、リリースのたびに npm に公開されます。

変更履歴

CHANGELOG.md をご覧ください。

リンク

📦 npm：https://www.npmjs.com/package/@astroway/mcp
📘 API ドキュメント：https://api.astroway.info/docs/api/
🔑 登録とダッシュボード：https://api.astroway.info/dashboard/
💰 料金：https://api.astroway.info/pricing/
🌐 ウェブサイト：https://astroway.info

ライセンス

MIT ライセンスです。詳細は LICENSE をご覧ください。

Markdown 対応

ログインしてコメント

基本情報

作者: astroway
トランスポート: stdio
掲載日: 2026年5月7日
最終更新: 3 週間前

問題を報告

MCP は初めてですか？

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

入門ガイドを読む

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