Asterwise

Asterwise MCP サーバー

占星術と占いの計算を行う MCP ツールです。ヴェーダ占星術と西洋占星術、数秘術、タロット、クリスタル、夢、出生図、ダシャー、相性診断、パンチャンガを網羅する 118 個のツールを備え、古典的なジョーティシュの手法に沿った解釈を提供します。すべての位置は、独立した Swiss Ephemeris の実行結果と照合して検証されており（asterwise.com/proof）、NASA JPL Horizons とも照合済みです。80 個の位置における中央値は 0.050 秒角です（asterwise.com/accuracy）。ほかの 7 つの占星術 API との比較（出典と日付を記載）はこちらです：asterwise.com/compare。

クイックスタート（2 分）

まずはこちらをご覧ください：Claude Desktop がこのサーバー経由でホロスコープを作成する 46 秒のデモと、独立した Swiss Ephemeris との照合結果。

API キーを取得する

asterwise.com/dashboard で無料登録すると、Sandbox プランで月 500 回まで呼び出せます。クレジットカードは不要で、利用期間の制限もありません。

Claude Desktop に接続する

~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "asterwise": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.asterwise.com/mcp"
      ],
      "env": {
        "MCP_HEADER_AUTHORIZATION": "Bearer your-api-key-here"
      }
    }
  }
}

Cursor に接続する

プロジェクト内の .cursor/mcp.json に追加します：

{
  "mcpServers": {
    "asterwise": {
      "url": "https://mcp.asterwise.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

接続をテストする

curl https://mcp.asterwise.com/health

認証

次の 3 つの方法をサポートしています：

方法 1 — API キー（クイックスタート）
Asterwise API キー（aw_ で始まります）を、Authorization: Bearer <api-key> または X-API-Key: <api-key> ヘッダーのいずれかで渡します。どちらも同等です。MCP クライアントで設定できるほうを使用してください。

方法 2 — OAuth 2.1（本番環境）
API キーを短期間有効なトークンに交換します：

curl -X POST https://mcp.asterwise.com/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "your-api-key",
    "client_secret": "your-api-key"
  }'

戻り値：{"access_token": "...", "expires_in": 3600, ...}

トークンを使用します：Authorization: Bearer <access_token>

アクセストークンはステートレスな HS256 JWT です。API キーは JWT_SECRET から導出されたキーで暗号化されてトークン内に格納され、sub クレームにはキーの SHA-256 ハッシュのみが含まれます。JWT_SECRET は非公開にしてください。

方法 3 — MCP クライアント（Claude、Cursor、VS Code、Smithery）向け OAuth 2.1 認可コード
MCP クライアントは、PKCE（S256）を使用する標準の認可コードフローを通じてユーザーをログインさせます。ディスカバリーは /.well-known/oauth-authorization-server で利用できます。クライアントの識別方法は 2 種類あります：

• Client ID Metadata Documents（現行の MCP 仕様で推奨）：HTTPS URL を client_id として使用します。この URL は、client_id が URL と一致し、client_name、redirect_uris、token_endpoint_auth_method: "none" を含む JSON ドキュメントを提供する必要があります。これらのクライアントはパブリッククライアントです。シークレットは不要で、PKCE のみを使用し、authorization_code と refresh_token のグラントに対応します。リフレッシュトークンは使用するたびにローテーションされます。リダイレクト URI は https、または localhost / 127.0.0.1 / [::1] 上の http である必要があります（RFC 8252 に従い、ポートは無視されます）。コピーして使用できる参考ドキュメントはこちらです：https://asterwise.com/public/oauth/example-client.json。
• Dynamic Client Registration（POST /oauth/register、MCP 仕様では非推奨ですが、引き続きサポートされています）：client_id と client_secret が返されます。/oauth/token ではシークレットが必要です。

サーバーは SSRF 対策を講じたうえでメタデータドキュメントを取得します（パブリックアドレスのみ、リダイレクトなし、64 KB、10 秒）。ドキュメントの Cache-Control: max-age に基づいてキャッシュされます（60 秒から 24 時間、既定値は 1 時間）。同意ページには、ドキュメントを公開したホストが表示されます。

stdio で実行する

HTTP ではなく stdio を使用するホスト（Glama のホスト型ビルド、ローカルの Claude Desktop エントリー、簡単なテスト）の場合：

pip install -r requirements.txt
ASTERWISE_API_KEY=aw_your_key python stdio.py

stdio では、キーは ASTERWISE_API_KEY から取得します。キーがなくてもサーバーは起動してツールを一覧表示しますが、ツールの呼び出しにはキーが必要です。ログは stderr に出力されます。

設定

.env.example を .env にコピーし、少なくとも次の項目を設定します。

変数	必須	説明
ASTERWISE_API_BASE_URL	はい	Asterwise API のベース URL（例：https://api.asterwise.com）。
JWT_SECRET	/oauth/token 用	32 文字以上。アクセストークンの署名に使用します。
MCP_SERVER_HOST / MCP_SERVER_PORT	いいえ	MCP HTTP サーバーのバインドアドレスとポート。
LOG_LEVEL	いいえ	デフォルトは INFO です。
MCP_OAUTH_SECRET	OAuth 用	asterwise-api と共有します。asterwise-api の /v1/oauth/token が発行したアクセストークンを検証します。
ASTERWISE_API_KEY	stdio のみ	python stdio.py 用の Asterwise API キーです。HTTP デプロイでは、リクエストごとにキーを渡します。
INTERNAL_API_TOKEN	OAuth クライアント登録用	asterwise-api と共有します。動的クライアント登録の転送に使用します。
FRONTEND_URL	/authorize 用	サインインと同意のためにブラウザーを転送する URL（例：https://asterwise.com）。
OPENAI_APPS_CHALLENGE_TOKEN	いいえ	ディレクトリの検証用に /.well-known/openai-apps-challenge で提供されます。

ツール（合計 118 個）

MCP サーバーは、Python モジュールごとに整理された 118 個のツールを公開します。この分類はコードの構成を反映したものです。ツールによっては複数の伝統に対応します（例：マッチメイキングには、サンスクリット語の Dashakoot とタミル語の Porutham の両方の方式が含まれます）。

• western — 25 個のツール（チャート、トランジット、リターン、プログレッション、ボイド・オブ・コースの月、惑星時、プロフェクション、食、日別ビュー、日別要因、イベント、ホラリー、意味づけ）
• natal — 13 個のツール（チャート、ダシャーのツリー、アセンダントの体系）
• factors — 5 個のツール（タラバラ、ヴェーダの日別要因、ヴェーダのイベント、BPHS の意味づけ、参照チャート）
• numerology — 11 個のツール（プロフィール、相性、ライフパス）
• tarot — 9 個のツール（カードを引く、スプレッド、スートのリファレンス）
• vedic_reference — 8 個のツール（ナクシャトラ、惑星の性質、アヤナーンシャ、古典的リファレンス）
• numerology_gaps — 7 個のツール（表現、ソウル・アージ、性格、成熟、バランス、カルマ、個人サイクル）
• panchanga — 6 個のツール（すべての要素と時刻を含むパンチャンガの日、月間カレンダー、ムフルタ検索、チョーガディヤ、ラーフ・カール、ホーラー）
• crystals — 5 個のツール（一覧、惑星別、おすすめ、個別）
• dasha — 5 個のツール（ヴィムショッタリ、アシュトッタリ、ヨーギニー、チャラ、トランジット）
• matchmaking — 5 個のツール（ダシャクート、ポルタム、ティルマナ、パーパサミヤム、相性）
• horoscope — 4 個のツール（日別／週別／月別／年別）
• yoga_dosha — 4 個のツール（ヨーガ、ドーシャ、サデ・サティ、ピトラ・ドーシャ）
• angel_numbers — 3 個のツール（今日、個人、検索）
• varshaphal — 3 個のツール（年運チャート、サハム、ハルシャ・バラ）
• dreams — 2 個のツール（シンボル、個別）
• panchanga_ext — 3 個のツール（祭日とヴラタのカレンダー、タミルのパンチャンガ、地名のジオコード化）

ツールの全一覧は docs.asterwise.com または MCP サーバーのツール一覧エンドポイントを参照してください。

ローカルで実行する

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
export ASTERWISE_API_BASE_URL=https://api.asterwise.com
export JWT_SECRET="$(python -c 'import secrets; print(secrets.token_hex(32))')"
uvicorn server:app --host 0.0.0.0 --port 8080

uvicorn server:app は、本番環境で Dockerfile と railway.toml が使用するものと同じエントリーポイントです。そのため、認証ミドルウェア、OAuth ルート、/health はすべてローカルでも利用できます。実行時の依存関係は requirements.txt に固定されており、requirements-dev.txt にはテスト用ツールが追加されています。

テスト

pytest

コアモジュール（auth、client、errors、logging_config、models、runtime、server）では、カバレッジ 78% が必須です。ツールモジュールはこの基準の対象外です（.coveragerc を参照）。

ステータス

https://status.asterwise.com

ライセンス

MIT です。LICENSE を参照してください。セキュリティに関する報告については、SECURITY.md を参照してください。