MCP — Claude / Cursor接続

AstroWayのMCPサーバーは、すべての723エンドポイントをAIエージェント向けのツールとして公開しています。2つのモードをサポートしており、いずれもMCP互換クライアントでネイティブに動作します。

モード	URL / コマンド	選択するタイミング
Hosted HTTP	`https://mcp.astroway.info/mcp`	ブラウザ版Claude（claude.ai）、Claude Desktop / Cursor / Code newcomers（npm不要）、ゼロインストールで使いたい場合
Stdio (npm)	`npx @astroway/mcp`	Cursorのパワーユーザー、ローカル開発、プライバシー重視（APIキーが自分のマシンから出ない）、オフライン環境

Hostedエンドポイントとnpmパッケージは同じツールセットを使用します（いずれも/v1/openapi.jsonから生成）。認証方法は同じaw_test_* / aw_live_* APIキーです。Hostedの場合はAuthorization: Bearer …ヘッダーで、stdioの場合はASTROWAY_API_KEY環境変数で送信されます。

Source: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · hosted: mcp.astroway.info/health

Hosted (`mcp.astroway.info`) — ゼロインストール

npm不要で手軽に始められる。まずはapi.astroway.info/dashboard/sign-upでAPIキーを取得しよう（月間10 000クレジットまで無料）。

ボタンをクリックすると、Cursorが起動して確認を求められ、自動的に設定が追加されます。

Cursorでインストール →

Cursorはdeeplinkでシークレットを埋め込めないため、~/.cursor/mcp.jsonにBearer YOUR_API_KEYというリテラルが書き込まれ、サーバーから403 invalid_formatが返されます。

ボタンをクリックした後:

Cursor Settings（⚙️右上） → Tools & MCP → リストからastroway-hostedを見つける。
サーバー横の三点リーダー（⋯） → Edit configurationをクリック。
AuthorizationフィールドのBearer YOUR_API_KEYをBearer aw_test_…（またはaw_live_…）に置き換える。これはDashboardから取得した実際のキーです。
保存 → MCPリストを開き直し、enabledステータスで緑のドットと630 tools enabledのカウンターが表示されていることを確認。

直接ファイルを編集することも可能：~/.cursor/mcp.json（headers.Authorization）。

JSONを編集することなく設定できます。Claude Desktopのチャットで以下の手順を実行：

チャット入力フィールド左の**+をクリック → メニューから「Add connector」**を選択。
ダイアログで**「Add custom connector」**を選択。
Name: astroway-hosted
URL: https://mcp.astroway.info/mcp
**「Advanced settings」**を展開 → **「Custom headers」**に以下を追加：
- Key: Authorization
- Value: Bearer aw_live_...（自分のキー）
Add → Connectorsリストからastroway-hostedを見つけ、スイッチをオンにする。

Claude Desktopを再起動する必要はありません。新しいチャットで+をクリックすると、Connectorsにastroway-hostedが表示され、630個のツール、12個のプロンプト、14個のリソースが利用可能になります。

Cline / Continue / Windsurf、または古いバージョンのClaude Desktop / Cursor向け：

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

設定ファイルのパス：

Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
Cursor: ~/.cursor/mcp.json（グローバル）または.cursor/mcp.json（ワークスペース）
Cline (VS Code): .cline/mcp.json（ワークスペース）
Continue: ~/.continue/config.json（mcpServersブロック）
Windsurf: ~/.codeium/windsurf/mcp_config.json

設定を編集したら、クライアントを完全に再起動（Cmd+Q → 再度開く）してください。

動作確認

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"2024-11-05"}

クライアントで「astroway-hostedから5つのAstroWayツール名をリストアップして」とリクエストすると、以下のようなツール名が返ってきます：astroway_western_chart、astroway_horoscope_daily、astroway_vedic_panchang_full、…

レート制限

Hostedエンドポイントは3層のレート制限で保護されています：Cloudflare DDoSレイヤー + nginx 120 req/min/IP + in-memoryバケット60/60s/(IP+key)。実際のMCPクライアント（Claude Desktop、Cursor）はこれらの制限に達することはありません。バーストリクエストを行わないためです。自動化やCIで120 req/min以上必要な場合は、stdioモードを使用してください（こちらにはレート制限がなく、api.astroway.info/v1/*に直接アクセスします。自分のプランのレート制限が適用されます）。

`mcp.astroway.info`が一時的に利用できない場合

Hostedエンドポイントが5xxを返すと、MCPクライアントはtools/listでエラーを検出します。これはstdioクライアントには影響しません—stdioクライアントはローカルのnpmパッケージを実行し、中間のHosted層を経由せずにapi.astroway.info/v1/*に直接アクセスします。

重要な統合のフォールバック: Hostedがtools/listに応答しない場合に備えて、設定に**2つ目のMCPサーバー（stdioモード）**を追加してください。クライアントは自動的にHostedが利用できない場合にフォールバックします：

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Hostedエンドポイントの実際の稼働状況はstatus.astroway.infoで確認できます。5分以上の障害が発生した場合は、5営業日以内にpostmortemを公開します（/sla/に基づく）。

Stdio (npm) — ローカル開発向け

@astroway/mcpは、ローカルでサブプロセスとして実行されるnpmパッケージです。単一のnpmパッケージで、Claude Desktop、Cursor、その他のMCP互換クライアントとネイティブに統合されます。

動作原理

ツールリストはビルド時にライブのOpenAPIスペック（api.astroway.info/v1/openapi.json）から生成されます。パッケージの各リリースで新しいエンドポイントが自動的に取り込まれるため、手動でメンテナンスする必要はありません。

各エンドポイントは以下の形式のツールとして公開されます：

tools/listは入力スキーマと説明（リクエストボディの例付き）を返す
tools/callはHTTP POSTをhttps://api.astroway.info/v1/<path>に送信し、その際にASTROWAY_API_KEYを使用する
応答は構造化JSONとしてエージェントに返される

各リリースではSLSA provenance（Sigstoreで検証済み）も同梱されており、npmパッケージが公開リポジトリの特定のコミットからビルドされたことが保証されます。

インストール方法

Claude Desktop (macOS)

~/Library/Application Support/Claude/claude_desktop_config.jsonに以下を追加：

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

Claude Desktopを再起動すると、チャット下のバーに🛠️アイコンとロードされたツール数が表示されます。

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

どのMCP互換クライアントでもnpx @astroway/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拡張機能	`~/.vscode/mcp.json`

その他のMCPクライアント

stdioサーバーとして起動：

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

プライバシー — v1.0.0以降

このMCPサーバーは、実行を依頼されたAPIコールのみをAstroWayに送信します。デフォルトでテレメトリーやアナリティクスは一切送信されません—オプトイン/オプトアウトの切り替えもありません。

送信されるリクエストには、MCPトラフィックをバックエンドのログで識別するための2つの識別ヘッダーが含まれます：

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

これらのヘッダーにはセッションID、マシンのフィンガープリント、個人情報は含まれません。これは標準的なUser-Agentのセマンティクスであり、すべてのCLIツールが同様の情報を送信しています。

サブセット登録 — v1.0.0以降

カタログの一部のみを使用する場合は、サブセットを登録してLLMのコンテキストウィンドウをコンパクトに保ちましょう：

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // これらのプレフィックスのみ
    "ASTROWAY_READONLY": "1"                               // LLMバック（ai/horoscope/reports）をスキップ（クレジット消費あり）
  }
}

よく使うグループ：western、vedic、tarot、numerology、hd（Human Design）、relational（合成図/コンポジット図/ダビソン図）、prognostics（トランジット/プログレッション/リターン）、aspects、horary、geo、chinese、bazi、mayan、iching、runes、geomancy。完全な一覧はnpx @astroway/mcp --list-toolsで確認できます。

ASTROWAY_READONLY=1は、内部でLLMを呼び出す3つのグループ（ai、horoscope、reports）をスキップします。テキスト生成によるクレジット消費を避けたい場合に便利です。

安定性のコミットメント — v1.0.0以降

**セッション中はカタログが固定されます。**npmパッケージのビルド時点で624個のツール、12個のプロンプト、14個のリソースが埋め込まれ、接続中に変更されることはありません。クライアントがtools/listを最初に呼び出した後にキャッシュしても、セッション全体で正しい状態が維持されます。
ツール識別子はメジャーバージョン内で安定しています。v1.x内では、astroway_<group>_<tool>という名前がリネームや削除されることはありません（非推奨の場合はCHANGELOG.mdに記載され、マイナーバージョンで並行して利用可能になります）。
**ツールの入力形状はマイナーバージョン内で安定しています。**引数（regex、range、enum）はパッチで追加されます。必須フィールドの追加はマイナーバージョンアップが必要です。
カタログの更新は再インストールで行います。npm i -g @astroway/mcp@latest（または設定ファイル内のnpx -y @astroway/mcp）で次回起動時に最新のセットが取り込まれます。

プロンプト例

サーバーを接続したら、AIに以下をリクエストしてみましょう：

出生図

1990年3月15日14:30、キエフ生まれの私の出生図を計算して。太陽、月、アセンダントを説明し、 tight なアスペクトを探して。

Claudeはchartツールを呼び出し、パラメータ付きの構造化JSONを受け取り、図を言葉で説明します。

トランジット

2027年に私の Natal 図に影響を与える、遅い惑星の重要なトランジットは？

Claudeは2つのツールコールを行います：最初にtransits（現在のスナップショット）、次にtransit-calendar（期間）。トレンドを解釈します。

Vedic Mahadasha

1985年7月22日6:45ムンバイ生まれの人の Vimshottari Mahadasha を実行して。現在どの期間にいる？

vedic/dashas/vimshottari/mahaツールを介して—現在の期間の正確なUTCタイムスタンプが返されます。

シナストリー

2つの図を比較して：A — 1988年6月10日9:15ロンドン、B — 1991年11月22日22:40ベルリン。最も強いクロスアスペクトは？

synastryツールに2つのchartブロックを渡し、互換性スコアの解釈を行います。

タロット

ライダー・ウェイト・スミスの3枚引き：過去・現在・未来。質問：「新しい仕事を受けるべきか？」シード=42。

tarot/rider-waite/spreadに固定シードを指定して再現性を確保。

すべてのツールの一覧

接続後、Claudeに以下をリクエスト：

すべてのastrowayツールを列挙して。

またはコマンドラインから：

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# （stdioサーバーを起動。プロトコル上のtool-list呼び出しはMCPクライアントが行う）

設定

変数	デフォルト値	説明	導入バージョン
`ASTROWAY_API_KEY`	(必須)	Live: `aw_live_...`。Sandbox: `aw_test_...`。	0.1.0
`ASTROWAY_BASE_URL`	`https://api.astroway.info/v1`	セルフホスト/ステージング環境向けの上書き。	0.1.0
`ASTROWAY_TOOL_GROUPS`	(すべてのグループ)	カタログを制限するカンマ区切りのプレフィックス（例：`western,vedic,relational`）。	1.0.0
`ASTROWAY_READONLY`	`0`	`1`でLLMバックのグループ（`ai`、`horoscope`、`reports`）をスキップ。	1.0.0
`LOG_LEVEL`	`error`	`silent`/`error`/`warn`/`info`/`debug` — stderrへのログレベル。	0.8.0
`LOG_FILE`	(書き込みなし)	ログの出力先ファイルパス。	0.8.0
`MCP_FLAT_TOOLS`	`0`	`1`でpre-v0.9のフラットな名前（例：`chart` → `astroway_western_chart`）を返す。レガシー。	0.9.0

なぜMCPで、直接統合ではないのか

一般的なLLM（groundingなし）は「7月に土星が木星と三分する」と曖昧な表現で答えるでしょう—正確な日付は±15日のずれがあります。MCPエージェントはtool_use POST /v1/transitsを実行し、Swiss Ephemerisを使用して秒単位のUTCタイムスタンプを返します。

メリットはLLMにあるのではなく、確実に正確な数学が保証される点にあります—決してでっち上げではありません。

パッケージの配布

mcp.so listing: mcp.so/server/astroway-mcp/astroway
mcpservers.org: 2026年5月現在承認待ち
awesome-mcp-servers (punkpeye): PR #5972