MCP - Claude / Cursor接続

AstroWay Model Context Protocolサーバーは、すべての 771 エンドポイントをAIエージェント用のツールとして公開しているよ。2つのモードがあり、どちらもすべてのMCP互換クライアントでネイティブにサポートされているんだ。

モード	URL / コマンド	選択するタイミング
Hosted HTTP	`https://mcp.astroway.info/mcp`	Claude Web (ブラウザのclaude.ai)、npmなしのClaude Desktop / Cursor / Code初心者、またはゼロインストールを希望する場合
Stdio (npm)	`npx @astroway/mcp`	Cursorのパワーユーザー、ローカル開発、プライバシー重視（キーがマシンから離れることはない）、オフライン対応

Hosted endpointと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でキーを取得してね（月10,000クレジット無料）。

ボタンをクリックすると、Cursorが開き、確認を求められ、自動的にエントリが追加されるよ：

Cursorにインストール →

Cursorはdeeplinkからシークレットを挿入できないんだ。~/.cursor/mcp.jsonにはリテラルBearer YOUR_API_KEYが書き込まれ、サーバーは403 invalid_formatで応答するよ。

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

Cursor Settings (⚙️ 右上隅) → Tools & MCP → リストからastroway-hostedを見つける。
サーバーの横にある3つの点 (⋯) をクリック → Edit configuration。
Authorizationフィールドで、Bearer YOUR_API_KEYをBearer aw_test_…（またはaw_live_…）に置き換える。これはDashboardにある君の実際のキーだよ。
保存 → MCPリストを再度開く → ステータスがenabledで緑色の点が表示され、780+ tools enabledのカウンターがあることを確認する。

または、ファイルを直接編集することもできるよ：~/.cursor/mcp.json (headers.Authorization)。

Settings → Developer → Edit Configを開くとclaude_desktop_config.jsonが開くよ。このファイルはローカルコマンドのみを実行するんだ。urlのみのエントリは「Some MCP servers couldn’t be loaded」というメッセージでスキップされるよ。Hostedサーバーはmcp-remoteブリッジ経由で接続され、Node.jsが必要なんだ：

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

Claude Desktopを完全に閉じて（Cmd+Q）、再度開いてね。キーはenvに入っているよ。なぜなら、Windows版のClaude DesktopはBearerの後のスペースで引数を分割してしまうからなんだ。

Settings → ConnectorsのAdd custom connectorダイアログは、名前とURLしか受け付けないんだ。Authorizationヘッダー用のフィールドがないから、現時点ではAstroWayキーをそこから渡すことはできないよ。

リモートurlを直接受け入れるCursor、Cline、Continue、Windsurfの場合：

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

設定ファイルのパス：

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":"…"}

クライアントで、「astroway-hostedからAstroWayのツール名を5つリストアップして」と尋ねてみてね。astroway_western_chart、astroway_horoscope_daily、astroway_vedic_panchang_fullなどの名前が返されるはずだよ。

レート制限

Hosted endpointは3段階の制限で保護されているよ：Cloudflare DDoS層 + エッジプロキシの120 req/min/IP + インメモリバケットの60/60s/(IP+key)。実際のMCPクライアント（Claude Desktop、Cursor）はこれらの制限に近づくことはないよ。バーストリクエストを行わないからね。もし君の自動化/CIが120 req/minを超える必要があるなら、stdioモードを使ってね（そちらには制限がなく、君の料金プランのレート制限でapi.astroway.info/v1/*に直接アクセスするよ）。

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

hosted endpointが5xxを返した場合、MCPクライアントはtools/listでエラーを見るだろう。これはstdioクライアントには影響しないよ。stdioクライアントはローカルのnpmパッケージを起動し、中間hosted層なしでapi.astroway.info/v1/*に直接アクセスするからね。

重要な統合のためのフォールバック: stdioモードで2番目のMCPサーバーをconfigに追加してね。hostedがtools/listに応答しない場合、クライアントは自動的にそれを使用するよ：

{
  "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 endpointの実際の稼働状況はstatus.astroway.infoで見ることができるよ。5分を超えるインシデントは、5営業日以内に事後分析として公開されるんだ（/sla/による）。

Stdio (npm) - ローカル開発用

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

仕組み

ツールリストは、ライブのOpenAPI仕様（api.astroway.info/v1/openapi.json）からビルド時に生成されるよ。パッケージの各リリースは、すべての新しいエンドポイントを自動的に取り込むから、手動で何かを維持する必要はないんだ。

各エンドポイントは次のようなツールになるよ：

tools/listは説明と入力スキーマ（リクエストボディの例を含む）を返す
tools/callは君のASTROWAY_API_KEYを使ってhttps://api.astroway.info/v1/<path>にHTTP POSTを行う
応答は構造化されたJSONとしてエージェントに返される

各リリースはSLSA provenance（Sigstore-attested）も同梱しているよ。これは、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

同じnpx @astroway/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)	preview-フラグ → ワークスペース内の`mcp.json`
VS Code MCP extension	`~/.vscode/mcp.json`

その他のMCPクライアント

stdioサーバーとして起動してね：

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

プライバシー - v1.0.0+より

このMCPサーバーは、君が実行を指示したAPI呼び出し自体を除いて、AstroWayに何も送り返さないよ。テレメトリーも、アナリティクスも、オプトイン/オプトアウトの切り替えも一切なく、デフォルトで静かに動作するんだ。

送信されるリクエストには、AstroWayバックエンドがMCPトラフィックと直接HTTPトラフィックを自身のログで区別できるように、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",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

一般的なグループは、western、vedic、tarot、numerology、hd (Human Design)、relational (synastry/composite/davison)、prognostics (transits/progressions/returns)、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+より

カタログはセッション中フリーズされるよ。 780以上のツール、12のプロンプト、14のリソースは、ビルド時に公開されたnpmパッケージに組み込まれているから、接続中に何も変更されることはないんだ。もし君のクライアントが最初の呼び出し後にtools/listをキャッシュするなら、それはセッション全体で有効なままになるよ。
ツール識別子はメジャーバージョン内で安定しているよ。 astroway_<group>_<tool>という名前は、CHANGELOG.mdでの非推奨通知と、同じマイナーバージョンでの並行提供なしに、v1.x内で名前が変更されたり削除されたりすることはないんだ。
ツールの入力形式はマイナーバージョン内で安定しているよ。 厳密化（regex、range、enum）はパッチで提供されるよ。必須フィールドの追加にはマイナーバージョンのバンプが必要になるんだ。
カタログの更新：再インストールで。 npm i -g @astroway/mcp@latest（または君のconfigにあるnpx -y @astroway/mcp形式）は、次回の起動時に現在のセットを取得するよ。

プロンプトの例

サーバーに接続したら、AIに尋ねてみてね：

出生図

私の出生図を計算して。1990年3月15日14時30分、キエフ生まれ。太陽、月、アセンダントを説明し、タイトなアスペクトを見つけて。

Claudeは君のパラメーターでchartツールを呼び出し、構造化されたJSONを受け取り、チャートを言葉で説明するよ。

トランジット

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

Claudeは2つのツール呼び出しを行うよ。まずtransits（現在のスナップショット）、次にtransit-calendar（期間）。そしてトレンドを解釈するんだ。

ヴェーダのマハダシャー

1985年7月22日午前6時45分にムンバイで生まれた人のヴィムショッタリ・マハダシャーを実行して。この人は今どの期間にいるの？

vedic/dashas/vimshottari/mahaツールを通じて、現在の期間の正確なUTCタイムスタンプがわかるよ。

シナストリー

2つのチャートを比較して：A - 1988年6月10日09時15分ロンドン、B - 1991年11月22日22時40分ベルリン。最も強いクロスアスペクトは何？

2つのchartブロックを持つsynastryツールと、相性スコアの解釈だよ。

タロット

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

再現性のために固定シード値を持つtarot/rider-waite/spreadだよ。

全ツールのリスト

サーバーに接続したら、Claudeに尋ねてみてね：

すべてのastrowayツールをリストアップして。

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

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

設定

変数	デフォルト	説明	バージョンから
`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`はv0.9以前のフラット名（`astroway_western_chart`の代わりに`chart`）を返す。レガシー。	0.9.0

なぜ直接統合ではなくMCPなのか

一般的なLLM（グラウンディングなし）は、「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

リンク

📦 npm: npmjs.com/package/@astroway/mcp
📘 API docs: /docs/api/
🔑 Sign up: /dashboard/sign-up
💰 Pricing: /pricing/
🌐 Public repo (MIT): github.com/astroway/astroway-mcp

参考になりましたか？

編集を提案

最終更新日: 2026/10/10