Hari Libur Indonesia

mcp-hari-libur-indonesia

2025年、2026年、2027年のインドネシアの国民の祝日と共同休暇（cuti bersama）を把握し、これらの日を使って稼働日を計算するMCP サーバーです。情報は大臣合同令（SKB 3 Menteri）に基づいています。この日付は稼働日か、2つの日付の間に稼働日は何日あるか、今から N 稼働日後の日付はいつか、といった計算ができます。オフラインで動作し、API キーは不要です。ファイルは1つで、依存関係もありません。

例：「Kalau pesanan masuk 17 Maret 2026 dan SLA-nya 3 hari kerja, kapan paling lambat dikirim?」 → 2026年3月27日（ニェピとレバランの祝日は除外されます）。

🇮🇩 インドネシア語：［以下のセクション](#bahasa-indonesia)をご覧ください。

• すべての祝日に令の番号と情報源へのリンクが記載され、すべての回答の末尾に情報源の行が表示されます。
• **共同休暇（cuti bersama）**を休業日として数えるか（祝日ではなく休暇です）、土曜日を稼働日とするかを選択できます。
• タイムゾーンに安全に対応しています。日付は通常の暦日として扱い、実行環境のタイムゾーンを通して変換されることはありません。「今日」は Asia/Jakarta（WIB）での今日を意味します。
• 回答はインドネシア語で、英語のフィールド名を使った JSON ブロックが含まれます。

ツール

ツール	機能	入力
daftar_libur	年（必要に応じて月も指定）の国民の祝日と共同休暇を、曜日、種類、SKB の情報源とともに一覧表示します。	year（2025-2027）、month（1-12）、include_cuti_bersama（デフォルトは true）
cek_tanggal	日付が国民の祝日、共同休暇、週末、稼働日のいずれかを判定します。理由をすべて示します（例：「Idulfitri + Sunday」）。	date（デフォルトは今日）、cuti_bersama_off、saturday_working
hitung_hari_kerja	2つの日付の間の稼働日数を計算します（デフォルトでは両端の日付を含む）。平日に当たる祝日の一覧も表示します。日付の順序が逆の場合は入れ替えて、そのことを示します。	start、end、count_start（デフォルトは true）、cuti_bersama_off、saturday_working
hari_kerja_berikutnya	ある日付から N 稼働日後の日付を計算します（N が負の場合は前の日付です）。開始日は数えません。n: 0 の場合、指定日が稼働日ならその日、そうでなければ次の稼働日を返します。SLA、期限、発送日の見積もりに便利です。	date（デフォルトは今日）、n（-750..750）、cuti_bersama_off、saturday_working

以下の3つのツールで共通のオプション：

オプション	デフォルト	意味
cuti_bersama_off	true	共同休暇を休業日として扱います。共同休暇中も営業する事業者は false に設定してください。
saturday_working	false	週6日制：土曜日を稼働日とします。土曜日に当たる国民の祝日は休業日のままです。

日付の形式：YYYY-MM-DD（DD-MM-YYYY、DD/MM/YYYY、DD.MM.YYYY、today、hari ini も使用できます）。米国式の順序 MM/DD/YYYY は誤読を避けるため受け付けません。存在しない日付（例：2026-02-29、2026-04-31）は理由とともに拒否されます。

{"date": "2026-12-23", "n": 5} を指定した hari_kerja_berikutnya の JSON 出力例（一部省略）：

{
  "date": "2026-12-23",
  "n": 5,
  "result": "2027-01-04",
  "result_weekday": "Monday",
  "skipped_holidays": [
    { "date": "2026-12-24", "holidays": [{ "type": "cuti_bersama", "name": "Cuti bersama Kelahiran Yesus Kristus" }] },
    { "date": "2026-12-25", "holidays": [{ "type": "libur_nasional", "name": "Kelahiran Yesus Kristus" }] },
    { "date": "2027-01-01", "holidays": [{ "type": "libur_nasional", "name": "Tahun Baru 2027 Masehi" }] }
  ],
  "options": { "cuti_bersama_off": true, "saturday_working": false, "timezone": "Asia/Jakarta" }
}

インストール

Node.js 18 以降（node -v）が必要です。npx を使う場合、ほかにインストールするものはありません。アプリから npx -y mcp-hari-libur-indonesia を実行してください。

Claude Desktop：設定 → 開発者 → 設定ファイルを編集（claude_desktop_config.json）を選択し、Claude Desktop を完全に終了してから再起動してください。

{
  "mcpServers": {
    "hari-libur": {
      "command": "npx",
      "args": ["-y", "mcp-hari-libur-indonesia"]
    }
  }
}

Claude Code

claude mcp add hari-libur -- npx -y mcp-hari-libur-indonesia

すべてのプロジェクトで利用できるようにするには、--scope user を追加してください。claude mcp list で確認できます。

Cursor：全プロジェクトで使う場合は ~/.cursor/mcp.json、1つのプロジェクトで使う場合は .cursor/mcp.json を使用します。JSON は Claude Desktop と同じです。

OpenCode：プロジェクト内の opencode.json、または ~/.config/opencode/opencode.json を使用します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hari-libur": {
      "type": "local",
      "command": ["npx", "-y", "mcp-hari-libur-indonesia"],
      "enabled": true
    }
  }
}

Windows：アプリから npx を起動できない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "mcp-hari-libur-indonesia"] を使用してください。

ソースから実行する場合：git clone https://github.com/EzkielynaGroup/mcp-hari-libur-indonesia.git を実行し、"command": "node" と "args": ["/full/path/to/mcp-hari-libur-indonesia.mjs"] を指定してください。

環境変数は不要です。

データソース

祝日一覧は、各年の政令番号と出典リンクを含む JSON ブロックとして、mcp-hari-libur-indonesia.mjs 内の BEGIN HOLIDAY DATA と END HOLIDAY DATA の間に同梱されています。2026年11月11日に確認しました。

年	政令（宗教大臣、労働大臣、国家機構改革大臣の共同政令（SKB Menteri Agama, Menteri Ketenagakerjaan, Menteri PANRB））	署名日	日数	出典
2025	2024年政令番号1017、2024年政令番号2、2024年政令番号2。2025年政令番号933、2025年政令番号1、2025年政令番号3により改正（2025年8月7日署名：2025年8月18日を共同休暇として追加）	2024年10月14日	国民の祝日17日＋共同休暇11日（10日＋追加1日）	Kemenko PMK、Setneg（改正）
2026	2025年政令番号1497、2025年政令番号2、2025年政令番号5	2025年9月19日	国民の祝日17日＋共同休暇8日	Setneg
2027	2026年政令番号1205、2026年政令番号3、2026年政令番号2	2026年9月15日	国民の祝日18日＋共同休暇8日	Setneg

データについて知っておくべきこと：

• イドの日付。 各SKBでは、ラマダン初日、イドゥルフィトリ、イドゥルアドハーの日付は、宗教大臣の決定（イスバット会合後）によって確定するとされています。2025年と2026年は、確定した日付がSKBと一致しました（イスバットの結果に関する報道によると、イドゥルフィトリ1446年は2025年3月31日、イドゥルアドハー1446年は2025年6月6日、イドゥルフィトリ1447年は2026年3月21日、イドゥルアドハー1447年は2026年5月27日です）。2027年の日付はまだ確定していないため、2027年のイドの日付は予定として扱ってください。
• 2027年にはイスラ・ミクラジの祝日が2日あります（2027年1月5日と2027年12月26日）。これはイスラム暦がグレゴリオ暦より約11日短いためです。政令に記載されており、重複ではありません。
• 含まれないもの： 地域の祝日、任意の祝日（libur fakultatif）、選挙日などの一度限りの祝日。2026年11月11日以降の政令の変更は、データが更新されるまで含まれません。
• Cuti bersama は年次有給休暇を減らします。各SKBでは、民間部門については雇用主、公務員についてはそれぞれの規則に委ねているため、cuti_bersama_off オプションがあります。
• 上記の政府ページ（SetnegとKemenko PMKが政令の内容を公開しています）から日付をまとめました。署名済み政令のPDFそのものは確認していません。政令の本文と異なる点を見つけた場合は、リンクを添えてイシューを登録してください。
• データは、政府が公開している祝日の日付と名称です。上記の出典を明記したうえで、事実情報として再配布しています。

安全性と制限

• オフラインで動作します。ネットワーク通信は行わず、ファイルも書き込まず、キーも必要ありません。
• 対応範囲はデータがある年に限られます。cek_tanggal で2025～2027年以外の日付を指定した場合も、週末かどうかは回答し、祝日データがないことを警告します。hitung_hari_kerja と hari_kerja_berikutnya は推測せずに処理を拒否します。
• エラーは短いインドネシア語と英語のメッセージで返し、スタックトレースは返しません。ログはstderrに出力し、stdoutにはMCPメッセージのみを出力します。

よくある質問

2026年のインドネシアの祝日は何ですか？ SKB 3 Menteri Nomor 1497 Tahun 2025、2 Tahun 2025、5 Tahun 2025 により、国民の祝日は17日、cuti bersama は8日と定められています。曜日を含む一覧を取得するには、daftar_libur に year: 2026 を指定してください。

インドネシアでは cuti bersama は祝日ですか？ いいえ。cuti bersama は年次休暇を消化する一斉休暇であり、国民の祝日（libur nasional）とは別です。cuti bersama を適用するかどうかは民間企業が決定するため、このサーバーでは休業日として数えるか、勤務日として数えるかを選択できます。

祝日を除外して、インドネシアの勤務日を数えるにはどうすればよいですか？ 開始日と終了日を指定して hitung_hari_kerja を使用してください。週末、国民の祝日、そしてデフォルトでは cuti bersama が除外され、除外された祝日がすべて一覧表示されます。

インドネシアで、勤務日数に基づく SLA の期限を計算するにはどうすればよいですか？ 注文日と勤務日数を指定して hari_kerja_berikutnya を使用してください。たとえば、{"date": "2026-03-17", "n": 3} を指定すると、ニュピとレバランの祝日が除外されるため、2026年3月27日が返されます。

2027年のインドネシアの祝日は、すでに決まっていますか？ はい。SKB 3 Menteri Nomor 1205 Tahun 2026、3 Tahun 2026、2 Tahun 2026（2026年9月15日署名）により、2027年の国民の祝日は18日、cuti bersama は8日と定められています。断食明け大祭の日付は、引き続き isbat の決定に従います。

開発

node --test test/

テストでは stdio 経由でサーバーを起動し、各ツール、同梱データ（政令ごとの件数、実際の日付、日付ごとに1項目）、年の境界、うるう年、逆順の範囲、無効な日付、複数のマシンタイムゾーンを検証するとともに、独立した日付実装と総当たりで照合します。ネットワーク接続は不要です。

年を追加するには、データセクションの年ブロックをコピーし、新しい SKB に基づいて（政令、日付、ソース URL、祝日）を入力して、テストの期待件数を更新し、テストを実行します。

---

インドネシア語

MCP サーバーには、SKB 3 Menteri に基づく2025年、2026年、2027年のインドネシアの国民の祝日と共同休暇に加え、稼働日の計算機能が含まれています。インターネット接続も API キーも不要で、Node.js 18 以降で動作します。

ツール

• daftar_libur：年ごとの国民の祝日と共同休暇の一覧を、月で絞り込んで表示できます。曜日、種類、SKB の出典も含まれます。
• cek_tanggal：指定した日付が国民の祝日、共同休暇、週末、または稼働日かどうかを理由とともに確認します。デフォルトは今日（WIB）です。
• hitung_hari_kerja：2つの日付の間の稼働日数を計算します（両端の日を含みます）。日付の順序が逆の場合は自動的に入れ替え、そのことを示します。
• hari_kerja_berikutnya：N 稼働日後の日付を返します（N が負の場合は過去にさかのぼります）。SLA、期限、配送予定の見積もりに適しています。

オプション：cuti_bersama_off（デフォルトは true。共同休暇を休日として計算します。共同休暇中もオフィスが営業する場合は false を指定します）と、saturday_working（デフォルトは false。週6日稼働にする場合は true を指定します。土曜日の国民の祝日は引き続き休日です）。

日付形式：YYYY-MM-DD、DD-MM-YYYY、DD/MM/YYYY、hari ini。存在しない日付（例：2026-02-29）は、その理由とともに拒否されます。計算には純粋な暦日を使用するため、コンピューターのタイムゾーンの影響を受けません。「今日」は Asia/Jakarta に基づきます。

データソース（2026年11月11日確認）：

• 2025年：SKB Nomor 1017 Tahun 2024、2 Tahun 2024、2 Tahun 2024（2024年10月14日）、その後、SKB Nomor 933 Tahun 2025、1 Tahun 2025、3 Tahun 2025（2025年8月7日）によって改定され、2025年8月18日の共同休暇が追加されました。国民の祝日17日＋共同休暇11日。
• 2026年：SKB Nomor 1497 Tahun 2025、2 Tahun 2025、5 Tahun 2025（2025年9月19日）。国民の祝日17日＋共同休暇8日。
• 2027年：SKB Nomor 1205 Tahun 2026、3 Tahun 2026、2 Tahun 2026（2026年9月15日）。国民の祝日18日＋共同休暇8日。2027年のイドゥルフィトリとイドゥルアドハーの日付は、宗教省のイスバット会議での決定待ちです。

地方の休日、任意の休日、特別休暇（例：投票日）は含まれていません。データは、署名済みの SKB PDF ではなく、SKB の内容を掲載している Setneg および Kemenko PMK のウェブサイトから収集しています。内容に相違がある場合は、リンクを添えて issue を作成してください。

インストール：アプリケーションに npx -y mcp-hari-libur-indonesia を追加します（設定例は上記を参照）。必要に応じて、Windows では cmd /c npx -y mcp-hari-libur-indonesia を使用してください。

---

Ezkielyna 制作。インドネシアの開発者向けの独立系 AI API ゲートウェイ（QRIS）：ezkielyna.store。

ライセンス

コードは MIT ライセンスです。祝日の日付は政府の公開情報であり、出典は上記に記載しています。