Kundlit Vedic Astrology

Kundlit ヴェーダ占星術 — MCP サーバー

Model Context Protocol を介して AI アシスタント向けに、無料でヴェーダ占星術の計算を提供します。任意の都市の日々のパンチャンとムフールタの時刻、ジャナム・クンドリーの出生図、クンドリー・ミラン（アシュタクータ）による相性判定、ドーシャのチェック、ダシャーの期間、トランジット、祭日と食のカレンダー、ヴェーダ数秘術に対応しています。動的に検出される17個のツールに加え、プロンプトとドキュメントのリソースも利用できます。

計算結果は決定論的です。スイス・エフェメリスを使用し、サイデリアル方式の黄道（ラヒリ・アヤナーンシャ）に基づいてリアルタイムで計算され、kundlit.com に掲載された古典文献の引用を参照しています。

• サーバー URL： https://kundlit.com/api/mcp（ホスト型、Streamable HTTP）
• 認証： 不要 — アカウントも API キーも必要ありません
• レート制限： IP あたり毎分30リクエスト
• ドキュメント： https://kundlit.com/mcp
• プライバシー： https://kundlit.com/privacy · サポート： [email protected]

インストール

1. npx（stdio のみのクライアントを含め、あらゆるクライアントで利用可能）

npx -y @kundlit/mcp

これにより、ホスト型エンドポイントへのプロキシとなるローカルの stdio MCP サーバーが起動します。コマンドを指定して、任意のクライアントから接続してください。

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "kundlit-astro": {
      "command": "npx",
      "args": ["-y", "@kundlit/mcp"]
    }
  }
}

Cursor — .cursor/mcp.json、または汎用の .mcp.json を読み込むクライアント：

{
  "mcpServers": {
    "kundlit-astro": {
      "command": "npx",
      "args": ["-y", "@kundlit/mcp"]
    }
  }
}

グローバルにインストールした場合（npm i -g @kundlit/mcp）、バイナリ名は kundlit-mcp です。そのため、引数なしで "command": "kundlit-mcp" としても動作します。

2. Streamable HTTP に直接接続（リモートサーバーに対応したクライアント）

ブリッジプロセスは不要です。URL に直接接続してください。

Claude Code：

claude mcp add --transport http kundlit https://kundlit.com/api/mcp

設定ファイル：

{
  "mcpServers": {
    "kundlit-astro": {
      "type": "http",
      "url": "https://kundlit.com/api/mcp"
    }
  }
}

Claude（ウェブ／デスクトップ）： Settings → Connectors → Add custom connector → https://kundlit.com/api/mcp

クライアントごとの詳しい手順、プロンプト例、制限事項はこちら： https://kundlit.com/mcp

このリポジトリの内容

ここから公開される npm パッケージ @kundlit/mcp はシンクライアントです。ローカルの StdioServerTransport と https://kundlit.com/api/mcp を対象とする StreamableHTTPClientTransport の間で、双方向に JSON-RPC を中継します。占星術のロジックやツール一覧の複製は含まれていないため、ホスト型サーバーにツールが追加または改名されても、パッケージを更新せずに反映されます。

フレームは、ホスト型サーバーへの通信が失敗した場合に、応答が返らないリクエストをローカルクライアントがいつまでも待ち続けないよう、ブリッジが保留中のリクエストに対してローカルで JSON-RPC -32001 エラー（bin/cli.js）を返すという意図的な例外を除き、両方向に変更せず転送されます。このエラーはブリッジが生成するもので、サーバーから送信されたことはありません。

占星術サーバー自体は kundlit.com でホストされており、そのソースは公開されていません。ここにあるマニフェスト（.mcp.json、server.json、.claude-plugin/plugin.json）は、MCP クライアント、レジストリ、ディレクトリがサーバーを検出してインストールできるようにするためのものです。

ブリッジのオプション

kundlit-mcp [--url <endpoint>]

  --url <endpoint>   Hosted MCP endpoint (default https://kundlit.com/api/mcp).
                     Also settable via KUNDLIT_MCP_URL; --url wins.
  -h, --help         Usage and a config snippet.
  -v, --version      Package version.

stdout には JSON-RPC のみが出力されます。--help と --version の出力を含むすべての診断情報は stderr に出力されます。Node.js 18 以降が必要です。

Docker

docker build -t kundlit-mcp .
docker run -i --rm kundlit-mcp

コンテナは stdio 経由で MCP を通信するため、-i を指定し、TTY なしで実行してください。

開発

npm install
node scripts/smoke.mjs   # end-to-end check against the live hosted server

機能

tools/list を介して動的に検出される17個のツール — パンチャン、ムフールタとチョーガディヤの時間帯、ジャナム・クンドリー、アシュタクータによる相性判定、マンガリク／カール・サルプ／サーデ・サーティーのチェック、ダシャーの期間、トランジット、パンチャ・パクシ、年間行事、食、数秘術に対応しています。プロンプトとドキュメントのリソース（kundlit://docs/methodology、kundlit://docs/usage-guide）も実行時に検出されます。この README の一覧に頼らず、クライアントにそれらを一覧表示するよう依頼してください。

プロンプト例

• 「ジャイプルの今日のパンチャンは？ ラーフ・カールは何時ですか？」
• 「1992年3月14日午前6時45分、ラクナウ生まれのジャナム・クンドリーを作成してください。現在のマハーダシャーは何ですか？」
• 「明日、プネーで賃貸契約に署名するのに良い時間を探してください。ラーフ・カールとバドラは避けてください。」
• 「バラナシの2026年のエーカーダシーの日付をすべて教えてください。」

注意事項

• 自由記述の place（世界中の任意の都市）を推奨します。緯度／経度／IANA タイムゾーンも指定できます。年別ツールでは、対応している50都市のうち最も近い都市に調整されます。
• 結果は情報提供を目的としており、専門家の助言に代わるものではありません。
• すべての結果には Source: の帰属表示行が含まれます。その帰属表示は無料アクセスの対価ですので、そのまま残してください。

ライセンス

MIT — LICENSE を参照してください。