US Federal Holidays and Business Days

米国連邦祝日と営業日 MCP

Claude、ChatGPT、Cursor、VS Code 向けの MCP サーバーです。1971年から2100年までの任意の日付について、米国の連邦祝日と営業日を正確に計算します。

モデルは暦の計算を間違えがちです。2022年の元日が2021年12月31日（金）に振り替えられたことや、政府機関が休みを取る金曜日に連邦準備銀行は営業していることを忘れてしまいます。このサーバーは、ネットワークへのリクエストなしで日付を正確に計算します。

ホスト型エンドポイント。トークンは不要です。

https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

ツール

ツール	内容
list_federal_holidays	1971～2100年の各年のすべての祝日を表示します。法定日、OPMの振替日、連邦準備銀行の休業日を示し、就任式の日はDC周辺地域のみと明記します。
is_business_day	federal（OPM）またはfed_banking（連邦準備銀行）のカレンダーに基づいて、指定日が営業日かどうかを示します。祝日の名称と、直前および直後の営業日も表示します。
add_business_days	営業日をN日分加算または減算します。計算中に除外した祝日をすべて一覧表示します。
count_business_days	2つの日付の間の営業日数を数えます。デフォルトでは、ExcelのNETWORKDAYSと同様に開始日と終了日を含みます。
invoice_due_date	発行日と支払条件（Net 30は暦日で30日）から支払期日を計算します。期日が週末または祝日の場合は、following、preceding、modified_followingを使って調整します。

すべての結果には、構造化されたJSON、1段落の概要、as_of、source（OPMまたは連邦準備銀行）、moreが含まれます。

モデルが把握していない情報

• 振替の規則です。土曜日の祝日は連邦職員について金曜日に振り替えられます（5 U.S.C. 6103(b)）。日曜日の祝日は月曜日に振り替えられます（E.O. 11582）。金曜日が前年になる場合もあります。
• 連邦準備銀行では異なる規則が適用されます。祝日が土曜日の場合、連邦準備銀行は金曜日も営業します（K.8）。そのため、2026-07-03は連邦祝日ですが、銀行の営業日です。ACH、電信送金、決済の日付にはcalendar: "fed_banking"を使用してください。
• 規則の変遷です。Juneteenthは2021年からです。MLK Dayは1986年からです。Veterans Dayは1971年から1977年まで、10月の第4月曜日でした。
• 就任式の日です。4年ごとに、DC周辺地域の連邦職員にのみ適用されます。1月20日が日曜日の場合は月曜日に移動し、土曜日の場合は振替日はありません（2029年）。
• OPMが公開している2011～2030年の祝日一覧、全212件がこのサーバーの出力と一致します。これを確認するテストがあります。

インストール

Claude.ai カスタムコネクターとChatGPT開発者モード

ホスト型URLを貼り付けてください。トークンもサインインも不要です。

https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http us-federal-holidays https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

または、stdio経由でローカル実行します。

claude mcp add us-federal-holidays -- npx -y us-federal-holidays-business-days-mcp

Claude Desktop

claude_desktop_config.jsonに次の内容を追加します。

{
  "mcpServers": {
    "us-federal-holidays": {
      "command": "npx",
      "args": ["-y", "us-federal-holidays-business-days-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.jsonに次の内容を追加します。

{
  "mcpServers": {
    "us-federal-holidays": {
      "url": "https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

VS Code

.vscode/mcp.jsonに次の内容を追加します。

{
  "servers": {
    "us-federal-holidays": {
      "type": "http",
      "url": "https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

プロンプトの例

• 「2027年の連邦祝日のうち、法定日とは異なる日に振り替えられるのはどれですか？」
• 「2026年7月3日は銀行の営業日ですか？連邦祝日ですか？」
• 「連邦政府機関の場合、2027年12月20日から10営業日後は何日ですか？」
• 「2026年11月の営業日は何日ありますか？」
• 「2026年6月3日にNet 30で請求書が発行されました。週末と銀行休業日を先送りすると、支払期日はいつですか？」

curlで試す

curl -s https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"is_business_day","arguments":{"date":"2026-07-03","calendar":"fed_banking"}}}'

データソース

すべて2026-10-30に取得しました。詳細はDATA_SOURCES.mdをご覧ください。

• OPMの連邦祝日。https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/
• 連邦準備銀行のK.8祝日一覧。https://www.federalreserve.gov/aboutthefed/k8.htm
• 5 U.S.C. 6103と改正注記。https://www.law.cornell.edu/uscode/text/5/6103

制限事項

• 大統領令による臨時の休業日は組み込まれていません。例として、クリスマスイブの休業や、2025-01-09 のような国民追悼の日があります。extra_closed_dates に指定してください。
• federal カレンダーは、月曜日から金曜日までの勤務週の従業員を対象としています。その他の勤務スケジュールでは、振替休日の日が異なります。
• fed_banking カレンダーでは、すべての年に K.8 ルールが適用されます。Fed が表を公開しているのは最近の年のみです。2022 年より前は、2021 年 6 月 19 日が土曜日だったため、Juneteenth のルールによって銀行営業日が変更されることはありませんでした。
• 州の祝日、株式市場の休場日、その他の国の祝日は対象外です。
• 日付は単純な暦日です。タイムゾーンや締め切り時刻はありません。

Zovo MCP バックオフィスバンドル

支払期日は、有料の Zovo MCP バックオフィスバンドルに含まれる請求書サーバーと督促サーバーに連携します。これらのサーバーは、請求書、支払条件、リマインダーを処理します：https://mcp.zovo.one/?utm_source=github&utm_medium=us-federal-holidays-business-days-mcp

Zovo MCP コレクションの一部です：https://mcp.zovo.one

開発

npm install
npm run build
npm test
npx wrangler deploy

src/core.ts には純粋なカレンダーロジックが含まれています。src/stdio.ts はローカルエントリポイント、src/worker.ts は Cloudflare Worker のエントリポイントです。どちらも src/tools.ts の同じツールレジストリを使用します。

ライセンス

MIT

同じ作者によるその他のデータサーバー

どれも無料で、API キーは不要です。Claude や ChatGPT に貼り付けられるホスト URL が用意されています。

サーバー	ツール	ホスト URL
cups-to-grams-mcp	convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature	https://cups-to-grams-mcp.lipmichal.workers.dev/mcp
dscr-loan-calculator-mcp	calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary	https://dscr-loan-calculator-mcp.lipmichal.workers.dev/mcp
gold-price-per-gram-mcp	get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units	https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp
lake-level-mcp	search_lakes, get_lake_level, get_lake_history, compare_lakes	https://lake-level-mcp.lipmichal.workers.dev/mcp
minimum-wage-mcp	get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage	https://minimum-wage-mcp.lipmichal.workers.dev/mcp
no-tax-on-overtime-mcp	calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility	https://no-tax-on-overtime-mcp.lipmichal.workers.dev/mcp
paycheck-calculator-mcp	calculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_brackets	https://paycheck-calculator-mcp.lipmichal.workers.dev/mcp
uk-income-tax-salary-mcp	calculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_income	https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp

有料のバックオフィスコレクション（請求書、VAT、PDF、スプレッドシート）は https://mcp.zovo.one にあります。