vedicchart

vedicchart

独自の占星術ロジックを持たない、ホスト型のヴェーダ占星術サービスへのローカル stdio ブリッジです。

ホスト型サービスは、Model Context Protocol を通じて無料のヴェーダ占星術を提供します。日々のパンチャン、ジャナマ・クンドリー出生図、クンドリー相性診断、ドーシャ判定（マンガリク、カール・サルプ、サデ・サティ）、ダシャー期間、トランジット、ムフールタの時刻、祭日と食のカレンダー、各種ヴェーダ数秘術など、全17種類のツールを利用できます。結果は決定論的で、サイデリアル方式の黄道帯（ラヒリ・アヤナーンシャ）に基づき、Swiss Ephemeris で計算されます。アカウントも API キーも不要です。ホスト型エンドポイントでは、IPアドレスごとに毎分30件のリクエストが許可されています。

vedicchart は、stdio のみを使用する MCP クライアント向けに作られています。tools/list はローカルで提供します。ツール名、説明、入力スキーマはホスト型サーバー独自のもので、2026-10-27 にライブで取得し、そのまま提供します。すべての tools/call はホスト型エンドポイントに転送し、結果を変更せずに返します。

設定

• KUNDLIT_MCP_URL（任意）— ホスト型 MCP エンドポイントです。 デフォルトは https://kundlit.com/api/mcp です。

呼び出しの流れ

転送される各呼び出しでは、エンドポイントに対してストリーム可能な HTTP の JSON-RPC シーケンスを実行します。

1. initialize リクエスト
2. notifications/initialized 通知
3. tools/call リクエスト本体

サーバーが Mcp-Session-Id ヘッダーを発行した場合、同じ呼び出し内の後続リクエストでそのヘッダーを返送します。サーバー送信イベント形式の応答だけでなく、通常の JSON 応答も解釈できます。

ホスト型サーバーへの接続に失敗した場合（到達不能、2xx 以外の応答、または利用できない応答）、クライアントを応答待ちのままにせず、JSON-RPC -32001 エラーとしてローカルで呼び出しを失敗させます。エラーメッセージは vedicchart error: で始まります。ホスト型サーバー自体がエラーを送信した場合も、同じプレフィックスを付けて、そのサーバー独自のメッセージを返します。

ツール

• get_panchang — 日付と場所を指定して、ヒンドゥー暦の日々の暦を取得します。ティティ、ナクシャトラ、ヨーガ、カラナ、ヴァーラ、日の出と日の入り、その日の吉祥・不吉な時間帯が含まれます。
• get_janam_kundali — ラグナ、9つのグラハ、進行中のダシャー、検出されたヨーガを含む詳細な出生図を取得します。
• get_kundli_match — 2つの出生図をアシュタクート方式で照合します。
• check_manglik — 出生図にマンガル・ドーシャがあるか、その強さを判定します。
• get_sade_sati — 出生図のサデ・サティの状態と各段階を取得します。
• check_kaal_sarp — カール・サルプ・ドーシャの有無と種類を判定します。
• get_pancha_pakshi — 出生星に基づくパンチャ・パクシの活動時間帯を取得します。
• get_muhurta_timings — 時刻選びに必要な時刻情報をまとめて取得します。チョーガディヤ、ホーラー、避けるべき時間帯が含まれます。
• get_year_events — 指定した年と場所の祭日や宗教行事を取得します。
• get_eclipses — 指定した年の日食と月食を取得します。
• get_numerology — 名前と生年月日からヴェーダ数秘術の数字を取得します。
• get_love_compatibility — 2人のパートナーの情報から相性を算出します。
• get_mobile_numerology — 携帯電話番号が持ち主とどのように共鳴するかを調べます。
• get_birth_details — 1人分の出生星と出生図の基本情報を取得します。
• get_dasha_periods — 出生図のヴィムショッタリ・ダシャー期間を取得します。
• get_upapada_arudha — ウパパダとアルーダ・ラグナを計算します。
• get_transits — 出生図に対する現在および今後の惑星トランジットを取得します。

各ツールの正式な説明（正確な入力、デフォルト値、注意事項）は、tools/list で提供されるものです。これはホスト型サーバー独自のテキストです。

CLI

各ツールは、1つの JSON 引数文字列を受け取るサブコマンドです。転送結果は JSON として出力されます。

npx @reneturcios/vedicchart get_panchang '{"place":"Jaipur, Rajasthan, India"}'
npx @reneturcios/vedicchart get_janam_kundali '{"birth_date":"1992-03-14","birth_time":"06:45","place":"Lucknow, India"}'
npx @reneturcios/vedicchart get_eclipses '{"year":2026}'
npx @reneturcios/vedicchart --version

終了コード：成功時は 0、実行時エラー時は 1、使用方法エラー時は 2 です。

MCP サーバー

npx -y @reneturcios/vedicchart mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/vedicchart
docker run --rm ghcr.io/cloudcorprecords/vedicchart get_eclipses '{"year":2026}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios