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 补休日、联邦储备银行停业日期，并标记仅适用于华盛顿特区地区的就职日。
is_business_day	判断某日期是否为 federal（OPM）或 fed_banking（联邦储备银行）日历中的工作日。提供假日名称，以及前一个和下一个工作日。
add_business_days	增加或减少 N 个工作日，并列出期间跳过的所有假日。
count_business_days	计算两个日期之间的工作日数。默认包含起止日期，与 Excel NETWORKDAYS 相同。
invoice_due_date	根据开票日期和付款期限计算到期日（Net 30 = 30 个日历日）。如果到期日是周末或假日，可使用 following、preceding 或 modified_following 调整。

每个结果都包含结构化 JSON、一段摘要、as_of、source（OPM 或联邦储备银行）和 more。

它了解而你的模型不了解的内容

• 补休规则。星期六的假日由联邦雇员在星期五补休（5 U.S.C. 6103(b)）。星期日的假日则在星期一补休（E.O. 11582）。补休的星期五可能在前一年。
• 联邦储备银行的规则不同。假日落在星期六时，储备银行在星期五照常营业（K.8）。因此，2026-07-03 是联邦假日，但仍是银行工作日。对于 ACH、电汇和结算日期，请使用 calendar: "fed_banking"。
• 规则的历史变化。六月节从 2021 年起设为假日。马丁·路德·金纪念日从 1986 年起设为假日。退伍军人节在 1971 年至 1977 年期间定于 10 月的第四个星期一。
• 就职日。每四年适用于华盛顿特区地区的联邦雇员。若 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 规则应用于每一年。美联储只发布了近几年的表格。2022 年之前，六月节规则从未改变银行工作日，因为 2021 年 6 月 19 日是星期六。
• 不涵盖州节假日、股市假日和其他国家。
• 日期均为纯日历日期，不涉及时区或截止时间。

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