FateStar Ziwei

FateStar Ziwei

AI エージェント向けの、紫微斗数に特化したホスト型 MCP です。URL は 1 つだけで、ローカルサーバー、パッケージのインストール、アカウント、API キーは不要です。出生図と 6 段階の運勢周期を利用できます。Agent Skill と REST API も利用できます。

简体中文

出生図と 6 段階の運勢周期は、匿名で利用できます。オプションの鄭大銭占いには、FateStar の API キーとクレジットが必要です。

今すぐ試す

匿名でライブのチャートレスポンスを開く。アカウントも API キーも不要です。レスポンスから選んだ項目：

Solar 1990-7-23 | Lunar 一九九〇年六月初二
Five-elements class 土五局 | Life ruler 文曲 | Body ruler 火星
Life palace 己卯 | 廉贞 (平), 破军 (陷)
12 palaces | 5 detected patterns | 4 natal transformations

Skill をインストールするか、MCP エンドポイントに接続したら、エージェントに次のように伝えてください。

1990 年 7 月 23 日午前 8 時生まれの男性の紫微斗数の命盤を作成し、2026 年の運勢周期を表示してください。

エージェントは FateStar を呼び出し、次の情報を返します。

• 12 宮、星曜、輝度、四化を含む出生図。
• 経度とタイムゾーンが指定されている場合の真太陽時補正。
• 大限、小限、年運、月運、日運、時運。
• 有効なキーとクレジットがある場合の、オプションの鄭大銭占い。

ライブの結果が役に立った場合は、リポジトリにスターを付けてください。ほかのエージェント開発者が無料のエンドポイントを見つけやすくなります。

FateStar を選ぶ理由

FateStar は意図的に対象を絞っています。ローカルの占星術サーバーを運用せずに、AI エージェントから紫微斗数のチャートデータを簡単に使えるようにします。

選択肢	適しているケース
FateStar	ホスト型のリモート MCP を今すぐ使いたい場合：URL は 1 つ、チャート作成は匿名で無料、運勢周期は 6 段階、MCP ネイティブの構造化出力に対応し、公式レジストリにも掲載されています。
Iztro	オープンソースの紫微斗数エンジンを、自分のアプリケーションに組み込んだり、調べたり、改変したりしたい場合。
Taibu または Horosa Skill	特定の紫微斗数エンドポイントに特化するより、より幅広い複数の占術体系やオフラインの占術ツールを利用したい場合。

これらは導入方法の違いであり、いずれかの流派やエンジンが常に最も正確だと主張するものではありません。

クイックスタート

Agent Skill

GitHub CLI 2.90 以降を使うと、Codex、Claude Code、Cursor など、多くのエージェントに Skill をインストールできます。

# Codex
gh skill install LouisLin0723/fatestar-ziwei ziwei-paipan --agent codex --scope user

# Claude Code
gh skill install LouisLin0723/fatestar-ziwei ziwei-paipan --agent claude-code --scope user

# Cursor
gh skill install LouisLin0723/fatestar-ziwei ziwei-paipan --agent cursor --scope user

エージェントを再起動し、紫微斗数の命盤を作成するよう依頼してください。正規の Skill は skills/ziwei-paipan にあります。

GitHub CLI が古い場合は、アップグレードするか、skills/ziwei-paipan ディレクトリをエージェントの Skill ディレクトリにコピーしてください。

ホスト型 MCP

ローカルサーバーは不要です。Streamable HTTP に対応したクライアントにリモートエンドポイントを追加してください。

{
  "mcpServers": {
    "fatestar-ziwei": {
      "url": "https://www.fatestar.top/api/mcp"
    }
  }
}

エンドポイントでは ziwei_chart、ziwei_transits、ziwei_reading を利用できます。最初の 2 つのツールは無料で、匿名で使用できます。

tools/list では、すべてのツールについて outputSchema と動作アノテーションが宣言されています。呼び出しが成功すると、ネイティブの structuredContent と従来の JSON テキストの両方が返されるため、新しいエージェントは型付きフィールドを利用でき、古いクライアントも引き続き動作します。

このサーバーは、公式 MCP Registry に io.github.LouisLin0723/fatestar-ziwei として登録されています。

REST API

アカウントなしで、無料の命式リクエストを実行できます。

curl "https://www.fatestar.top/api/ziwei?year=1990&month=7&day=23&hour=8&gender=male"

API とクライアントの詳しいドキュメント：fatestar.top/docs

統合方法を選択する

統合方法	最適な用途	インストール	無料の命式作成
エージェントスキル	Codex、Claude Code、Cursor、その他のコーディングエージェント	gh skill install	はい
ホスト型 MCP	リモート HTTP に対応した MCP クライアント	URL 1 つ	はい
REST API	アプリ、スクリプト、バックエンドサービス	curl または HTTP クライアント	はい

3 つの方法はいずれも、同じ FateStar エンジンを使用します。お使いのクライアントに合ったインターフェースを選んでください。

機能

機能	料金	備考
本命盤	無料	太陽暦または太陰暦の入力、12 宮、102 星、輝度、四化
6 段階の運勢	無料	大限、小限、年、月、日、時
真太陽時	無料	経度とタイムゾーンを入力すると有効になります
鄭大謙の鑑定	クレジット	FateStar のナレッジエンジンとホスト型鑑定サービス

このスキルには、Python、Node.js、PowerShell、Bash のクライアントが含まれています。Python と Node.js は標準ライブラリを使用するため、パッケージのインストールは不要です。

CLI の使用例

インストールした ziwei-paipan スキルのディレクトリで、次のコマンドを実行してください。

# Free natal chart
python scripts/ziwei_cli.py chart \
  --year 1990 --month 7 --day 23 --hour 8 --gender male

# Free 2026 transits
python scripts/ziwei_cli.py transits \
  --year 1990 --month 7 --day 23 --hour 8 --gender male \
  --target-year 2026

# Hosted reading, requires FATESTAR_API_KEY
python scripts/ziwei_cli.py reading \
  --year 1990 --month 7 --day 23 --hour 8 --gender male \
  --question "Should I change jobs this year?"

オフラインのインターフェースリファレンスを表示するには、python scripts/ziwei_cli.py doc を使用してください。同じディレクトリに、同等の Node.js、PowerShell、Bash クライアントがあります。

API キーと課金

chart と transits は、キーの有無にかかわらず無料です。キーを使用すると、無料の呼び出しがアカウントに紐付けられます。

reading には FSFSKey が必要で、クレジットを消費する場合があります。FateStar 開発者センターでキーを作成してください。ソース管理の対象外に保存してください。

export FATESTAR_API_KEY="FSFSKey_your_key"

MCP クライアントでは、ziwei_reading を使用する場合にのみ Authorization: Bearer FSFSKey_your_key を送信してください。実際のキーをコミットしたり、課題に貼り付けたりしないでください。

リポジトリの構成

skills/ziwei-paipan/
├── SKILL.md
├── agents/openai.yaml
├── scripts/
│   ├── ziwei_cli.py
│   ├── ziwei_cli.js
│   ├── ziwei_cli.ps1
│   ├── ziwei_cli.sh
│   └── shared/

ルートにある server.json には、公式 MCP Registry スキーマを使用してホスト型エンドポイントが記述されています。

開発

python skills/ziwei-paipan/scripts/generate.py --check
python tests/live_contract_check.py
python skills/ziwei-paipan/scripts/ziwei_cli.py doc
node skills/ziwei-paipan/scripts/ziwei_cli.js doc
powershell -ExecutionPolicy Bypass -File skills/ziwei-paipan/scripts/ziwei_cli.ps1 doc
bash skills/ziwei-paipan/scripts/ziwei_cli.sh doc

4 つのクライアントは、生成された定数とオフラインのインターフェース仕様を共有します。まず共有ファイルを編集し、generate.py を実行してから、上記のチェックを実行してください。 より広範な互換性マトリクスは docs/TEST_PLAN.md にあります。ホスト型 MCP の正確な検証項目とその制限については、docs/VERIFICATION.md に記載されています。

オープンソースの範囲

このリポジトリには、エージェントスキル、4 つの薄型クライアント、統合メタデータ、公開ドキュメントが含まれています。FateStar のサーバー実装、非公開プロンプト、鄭大謙のトレーニングデータ、検索コーパス、評価セット、課金制御は含まれていません。

リポジトリのコードは MIT ライセンスです。FateStar のブランド、ホスト型サービス、非公開のナレッジ資産は引き続き専有財産です。

貢献

バグ報告、クライアントの使用例、互換性の修正を歓迎します。プルリクエストを作成する前に、CONTRIBUTING.md をお読みください。セキュリティに関する報告は、公開課題ではなく SECURITY.md に記載してください。