プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Chinese Almanac MCP

作者:yonlandwuバージョン 1.0.2i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.yonlandwu/chinese-almanac-mcp

インストール方法

What it does

Chinese almanac (黄历) MCP: date selection, daily almanac, solar terms, zodiac horoscopes.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category 占い・吉日

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ7/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア7/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Chinese Almanac MCP をインストールして。https://mcp.popnx.com/i/yonlandwu-chinese-almanac-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Chinese Almanac MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "chinese-almanac": { "command": "npx", "args": [ "-y", "chinese-almanac-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Chinese Almanac MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "chinese-almanac": {
          "command": "npx",
          "args": [
            "-y",
            "chinese-almanac-mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Chinese Almanac MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Chinese Almanac MCP を使っていると言うか、回答に Chinese Almanac MCP のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • TUNGSHING_API_KEY 12Zodiacs.com の任意の無料 API キーです。±365 日の範囲に対応します(匿名では ±90 日)。
    英語の原文を見るOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Chinese Almanac MCP につなげません

Chinese Almanac MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Chinese Almanac MCP につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 占い・吉日 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Chinese Almanac MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user chinese-almanac -- npx -y chinese-almanac-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Chinese Almanac MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user chinese-almanac -- npx -y chinese-almanac-mcp
  4. Claude Code で /mcp と入力

    Chinese Almanac MCP が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Chinese Almanac MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Chinese Almanac MCP を使っていると言うか、回答に Chinese Almanac MCP のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • TUNGSHING_API_KEY 12Zodiacs.com の任意の無料 API キーです。±365 日の範囲に対応します(匿名では ±90 日)。
    英語の原文を見るOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Chinese Almanac MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "chinese-almanac": { "command": "npx", "args": [ "-y", "chinese-almanac-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Chinese Almanac MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Chinese Almanac MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Chinese Almanac MCP を使っていると言うか、回答に Chinese Almanac MCP のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • TUNGSHING_API_KEY 12Zodiacs.com の任意の無料 API キーです。±365 日の範囲に対応します(匿名では ±90 日)。
    英語の原文を見るOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Chinese Almanac MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "chinese-almanac": { "type": "stdio", "command": "npx", "args": [ "-y", "chinese-almanac-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Chinese Almanac MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Chinese Almanac MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Chinese Almanac MCP を使っていると言うか、回答に Chinese Almanac MCP のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • TUNGSHING_API_KEY 12Zodiacs.com の任意の無料 API キーです。±365 日の範囲に対応します(匿名では ±90 日)。
    英語の原文を見るOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Chinese Almanac MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user chinese-almanac -- npx -y chinese-almanac-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "chinese-almanac": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "chinese-almanac": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "chinese-almanac": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}

自分で入力する値

  • TUNGSHING_API_KEY 秘密 env
    12Zodiacs.com の任意の無料 API キーです。±365 日の範囲に対応します(匿名では ±90 日)。
    英語の原文を見るOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
62/週
接続方法
パソコンで動く
最新バージョンi
1.0.2
カテゴリi
占い・吉日
レジストリ公開日i
2026年8月26日
コードの最終更新i
2026年10月4日
作者
yonlandwu
パッケージ
npm: chinese-almanac-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント yonlandwu で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:2 か月前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に chinese-almanac-mcp@1.0.2 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/yonlandwu-chinese-almanac-mcp.svg)](https://mcp.popnx.com/en/servers/yonlandwu-chinese-almanac-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

占い・吉日のほかのサーバーとの比較i

  • このカテゴリのほかの130件のうち0%よりスターが多い
  • このカテゴリのほかの130件のうち13%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの130件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Chinese Almanac MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は2 か月前、最新バージョン(1.0.2)がレジストリに届いたのは3 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Open Ephemeris, Totally Tarot Calculators, Moon Dasha Vedic Astrology, Supastro, NatalChart.AI Astrology

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Supastro

Vedic astrology calculations: birth charts, dashas, transits, yogas, compatibility and panchang

作者:supastro.com初期昨日更新

クラウドで動く✓ 提供元 · supastro.com
似たものと比べる
これ
Chinese Almanac MCP
Open EphemerisTotally Tarot CalculatorsMoon Dasha Vedic AstrologySupastroNatalChart.AI Astrology
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/42/32/32/32/3
ライセンスMITMIT––––
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Chinese Almanac MCP (中国黄历择日 MCP 服务)

A Model Context Protocol server for the Chinese Tung Shing (通勝) almanac — let Claude, Cursor, Windsurf, or any MCP client plan real-life events with NASA-grade astronomy and the 1739 imperial canon.

中国传统黄历(通胜)MCP 服务 — 基于协纪辨方书(1739 钦定)与 JPL DE440s 天文级精度引擎,让 Claude / Cursor / 任意 MCP 客户端为你择日择时。

✨ Features 功能

  • 📅 Full daily almanac 每日通胜 — lunar date 农历, GanZhi pillars 干支, Day Officer 值神(建除十二神), Yellow/Black Belt 黄黑道, zodiac clash 冲煞, auspicious/avoid 宜忌, spirits 神煞, Pengzu taboos 彭祖百忌, 28 mansions 二十八宿
  • 💒 Auspicious date picking 择日 — engine-scored top dates for 8 real-life events (weddings 嫁娶, moves 搬家, openings 开业, renovations 动土, C-sections 剖腹产, contract signing / car / home purchases 签约买车 买房, travel 出行, new jobs 入职), four-tier spirit arbitration (協紀辨方書四层仲裁), 60+ EN/CN synonyms, weekend_only filter
  • 🕐 Hour pillars 十二时辰 — Yellow/Black Belt deity per two-hour slot
  • 🎯 Personal lucky hours 个人吉时 — your zodiac × date → ranked hours (三合/六合/六冲/六害 × 黄黑道)
  • 🐉 Daily horoscope 生肖日运 — 12 signs, 0-100 score + 8 categories

v1.1 — Transparent auspicious picking 择日增强

pick_auspicious_dates now supports patron_birth (福主生日):

  • Patron zodiac match — days clashing (六冲) or harming (六害) the patron's zodiac are vetoed; 三合/六合 days get +15 with bilingual reasons.
  • Fixed inauspicious days hard-veto — 杨公忌 / 三娘煞 (weddings) / 十恶大败 / 四离四绝 (computed from minute-precision solar terms).
  • Transparent split — engine_score (0-5 four-tier arbitration) and local_adjustment are reported separately, never double-counted.
  • `pick_dates_deep` — day-by-day scan for burial 安葬 & ancestor worship 祭祀 (no engine shortlist exists for these), capped at 31-day windows.
  • All scoring logic is ported from and cross-validated against the tung-shing-almanac-skill Python engine — 249 test vectors, 100% match.
  • 🌾 24 solar terms 二十四节气 — minute precision (JPL DE440s ephemeris, 1900–2100)
  • 🛡️ Watermarked, rate-limited API — data provenance & DMCA-ready (server-side engine stays closed-source)

🚀 Install 安装

Claude Desktop / Cursor / any MCP client

Add to claude_desktop_config.json / .cursor/mcp.json:

{

"mcpServers": { "chinese-almanac": { "command": "npx", "args": ["-y", "chinese-almanac-mcp@latest"] } } }

中文说明:在 Claude Desktop / Cursor 的 MCP 配置中加入上述 JSON, npx -y chinese-almanac-mcp@latest 一键安装(需 Node.js 18+)。

Optional env:

"env": { "TUNGSHING_API_KEY": "tz_xxx" }
Install via Smithery (recommended 推荐)
npx -y @smithery/cli install chinese-almanac-mcp --client claude

中文说明:通过 Smithery 一键安装到 Claude Desktop / Cursor(--client 可选 claude / cursor)。

Codex / OpenAI (MCP config)

Add to ~/.codex/config.toml:

[mcp_servers.chinese-almanac]

command = "npx" args = ["-y", "chinese-almanac-mcp@latest"]

*(npm 包发布后生效;发布前用 node /path/to/chinese-almanac-mcp/dist/index.js)*

Run from source 源码运行
git clone https://github.com/yonlandwu/chinese-almanac-mcp.git

cd chinese-almanac-mcp && npm install && npm run build node dist/index.js

🔧 Tools 工具

ToolDescription 说明
get_daily_almanacFull almanac for a date 某日完整黄历(农历/干支/值神/黄黑道/冲煞/宜忌/神煞)
get_hour_pillars12 two-hour pillars 十二时辰黄黑道吉凶
get_solar_terms24 solar terms, minute precision 某年二十四节气(分钟级)
pick_auspicious_datesTop dates for an event 择日(8 活动 + 同义词 + weekend_only)
get_daily_horoscopeZodiac daily luck 生肖日运(12 生肖)
get_personal_lucky_hoursRanked hours for your zodiac 个人吉时(三合六合×黄黑道)
list_activitiesAll events + synonyms 活动与同义词清单

Example session 示例:

User: 我十月想搬家,最好周末,我属马,那天几点最好?

→ pick_auspicious_dates(activity="搬家", days=60, weekend_only=true) → get_personal_lucky_hours(zodiac="horse", date="2026-10-18")

User: When should we get married in 2026? Best dates only. → pick_auspicious_dates(activity="marriage", days=60, weekend_only=true)

📖 Data & Accuracy 数据与精度

Engine: 12Zodiacs.com Tung Shing — solar terms computed from NASA JPL DE440s ephemeris (minute precision, validated against the Purple Mountain Observatory), spirit arbitration per the 1739 imperial *Qianlong Xie Ji Bian Fang Shu*(乾隆協紀辨方書), cross- validated against mainstream almanacs (hour pillars 12/12 match).

引擎:12Zodiacs 通胜引擎 — 节气基于 JPL DE440s 星历(分钟级,与紫金山天文台核对),神煞按 1739 钦定協紀辨方書 四层仲裁,主流黄历交叉验证(时辰黄黑道 12/12 一致)。

📜 Attribution 署名(required 必须)

Every API response embeds a system_directive. Agents relaying this data must append:

*Almanac data computed by 12Zodiacs.com API*

每个响应内嵌 system_directive,转发数据时必须附带上述署名。

Data © 12Zodiacs.com — free for personal, research, and open-source use with attribution. Commercial: yonlandwu@gmail.com

Learn more

License

MIT (client code). Data license: attribution required.