calendar-mcp

中国カレンダー＆旧暦 MCP

AI エージェント向けの中国カレンダーツール：法定祝日と振替出勤日のスケジュール（中国国務院の発表に基づく2025～2026年分）に加え、正確な新暦から旧暦への変換（旧暦の日付、十二支、干支）。

• 30秒でお試しいただけます：無料の公開 MCP エンドポイントがすでに稼働しています。URL を MCP クライアントに貼り付けるだけです（インストールも API キーも不要）。
• またはセルフホスト：小規模な FastMCP サーバーです。祝日データはローカルに同梱され、旧暦の変換には sxtwl 天文暦ライブラリを使用します（純粋な Python 製の lunardate へのフォールバックにも対応しています）。

⚡ ホスト済みエンドポイントを使用する（セットアップ不要）

https://mcp.pianam.cn/calendar-mcp/mcp

トランスポート：Streamable HTTP（MCP 2025-03-26 互換）。認証は不要です。

🔌 クライアント設定

MCP クライアントの mcpServers 設定（Claude Desktop の claude_desktop_config.json、Cursor の mcp.json、Cline、Cherry Studio など）に以下を追加します：

{
  "mcpServers": {
    "calendar": {
      "type": "http",
      "url": "https://mcp.pianam.cn/calendar-mcp/mcp"
    }
  }
}

"type": "http" を受け付けないクライアントでは、同じ設定の "url" だけを使用してください。

🧰 ツール

| ツール | パラメーター | 戻り値 | |

---|---|---| | query_holiday(date) | date：新暦の日付 YYYY-MM-DD。例："2026-10-01"。 | 曜日、祝日名（該当する場合）、日付の種別（法定休日／振替出勤日／通常の出勤日／週末）、およびその日の旧暦の日付。 | | solar_to_lunar(year, month, day) | year／month／day：新暦の日付を表す整数。 | 旧暦の年／月／日、閏月フラグ、旧暦の日付（中国語）の文字列、十二支、年／月／日の干支（干支）。 | | list_holidays(year) | year：年を表す整数。例：2026。 | その年のすべての法定祝日：名称、休日数、日付の範囲、正確な休日の日付、振替出勤日の日付。 |

例

• 「2026-10-01 は祝日ですか？」→ 国慶節の祝日と旧暦の日付。
• 「2026-02-17 の旧暦は何ですか？」→ 旧暦の日付、十二支、干支。
• 「2026年の法定祝日と振替休日の予定をすべて一覧表示して」→ 年間の全スケジュール。

📡 データ

• 祝日：中国国務院弁公庁（国务院办公厅）が発表した公式の祝日安排通知です。2025年と2026年のデータをローカルに同梱しています。HOLIDAY_DATA を拡張すると、他の年を追加できます。
• 旧暦への変換：sxtwl（寿星天文暦、C 拡張）。sxtwl を利用できない場合、サーバーは純粋な Python 製の lunardate ライブラリに自動でフォールバックします（別途インストールしてください）。
• 外部 HTTP API も API キーも必要ありません。

🐢 セルフホスト

git clone https://github.com/boy-373/calendar-mcp.git
cd calendar-mcp
pip install -r requirements.txt
python server.py
# listens on 127.0.0.1:8000 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py
# behind a reverse proxy, allow your public hostname:
#   MCP_ALLOWED_HOSTS="your-domain.com,your-domain.com:*" python server.py

MCP クライアントの接続先を http://127.0.0.1:8000/mcp に設定します。

uv を使ってサーバーを実行することもできます：

uv venv && uv pip install -r requirements.txt
uv run python server.py

🗂️ ファイル

• calendar_server.py — MCP サーバー：祝日データ、旧暦変換、FastMCP ツール定義。
• server.py — 単独で実行できる Streamable HTTP エントリーポイント（ホストとポートをバインドし、/mcp で MCP アプリを提供します）。
• requirements.txt — Python の依存関係。
• LICENSE — MIT。

---

🇨🇳 中国語の説明

中国の万年カレンダー MCP：法定祝日／振替出勤日の検索（国務院弁公庁の通知に基づく2025～2026年分）と、新暦から旧暦への変換（旧暦の年月日、閏月、十二支、干支）。

オンラインで直接接続（無料、キー不要）：https://mcp.pianam.cn/calendar-mcp/mcp

ツール：

• query_holiday(date)：新暦の日付の祝日／振替出勤日を検索し、旧暦の情報も表示します。
• solar_to_lunar(year, month, day)：新暦を旧暦に変換し、旧暦の日付、閏月、十二支、干支を返します。
• list_holidays(year)：指定した年のすべての法定祝日と、休日および振替出勤日を一覧表示します。

祝日データはローカルに同梱されています（2025年、2026年分。年ごとに拡張できます）。旧暦の変換には sxtwl 天文暦ライブラリを使用し、利用できない場合は純粋な Python 製の lunardate に自動でフォールバックします。外部 API やキーは一切不要です。

📄 ライセンス

MIT © 2026 boy-373 (刘扶阳)