Feiertage — German public holidays by year & federal state

io.github.mohammad-abbasi-sh由 GitHub 账号 mohammad-abbasi-sh 发布v0.1.0更新于 Nov 14, 2026

Unofficial read-only MCP server for German public holidays — by year & state, next holiday.

已验证STDIO仅桌面位置与生活

概览

AI 生成的概览

只读 MCP 服务器,让助手按年份和德国联邦州查询法定节假日、判断某日是否为假日并查找下一个假日。

可以做什么
  • 列出某联邦州某年的法定节假日,可按月份筛选
  • 判断指定日期在某州或全国范围内是否为法定节假日
  • 查找某日期当天或之后的下一个节假日,并列出日期区间内的节假日
  • 列出 16 个联邦州代码及全国性节假日集合,并检查接口可达性
适用场景
适合助手需要可靠的德国节假日日期来回答排期、截止日期或营业时间问题,或需要围绕特定联邦州的地区性假日做安排时使用。
运行要求
通过 stdio 在本机运行,通常用 uvx 或 python -m 启动 PyPI 包;需要 Python 及 mcp、httpx 依赖,并能访问 feiertage-api.de 服务。无需密钥或登录。
安装前请注意
为非官方项目,与 feiertage-api.de 及 bundesAPI 项目无关,用于法律或官方用途前应自行核实。虽为只读,但每次查询都会发送到第三方接口;部分条目只是放假说明(如学校假期),并非法定节假日。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Feiertage — German public holidays by year & federal state,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

feiertage-mcp 📅

mcp-name: io.github.mohammad-abbasi-sh/feiertage-mcp

Unofficial read-only MCP server for German public holidays (gesetzliche Feiertage) via the feiertage-api.de API (bundesAPI project): holidays per year and federal state, is-it-a-holiday checks, the next holiday from a date, and holidays in a date range. No key, no login.

Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with feiertage-api.de / the bundesAPI project.

For AI agents

Add to your MCP client config (stdio):

json
{  "mcpServers": {    "feiertage": {      "command": "uvx",      "args": ["feiertage-mcp==0.1.0"]    }  }}

Or run locally: python -m feiertage_mcp.server (needs mcp<2, httpx).

Tools

ToolDescription
feiertage_list_holidaysPublic holidays of one year in one federal state (optional month filter)
feiertage_is_holidayIs a date (YYYY-MM-DD) a public holiday in one state?
feiertage_next_holidayThe next public holiday on or after a date (looks into the next year)
feiertage_holidays_betweenPublic holidays in a date range (max ~2 years)
feiertage_list_statesAll 16 federal states + NATIONAL (nationwide holidays)
feiertage_healthReachability check (ok / blocked / error) — one polite request

Example output (feiertage_is_holiday / 2026-10-03, NATIONAL):

json
{"date": "2026-10-03", "weekday": "Saturday", "weekday_de": "Samstag", "state": "NATIONAL", "is_holiday": true, "holidays": ["Tag der Deutschen Einheit"], "details": [{"name": "Tag der Deutschen Einheit", "date": "2026-10-03",   "note": null, "note_only": false, "weekday": "Saturday",   "weekday_de": "Samstag"}]}

Notes:

  • State codes are the 2-letter codes: BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH — or NATIONAL for the nationwide holidays (Neujahrstag, Karfreitag, Ostermontag, Tag der Arbeit, Christi Himmelfahrt, Pfingstmontag, Tag der Deutschen Einheit, 1./2. Weihnachtstag). Use feiertage_list_states for the full list.
  • Holiday names are German; each dated holiday also carries its weekday in English and German.
  • A few entries have no date (note_only: true) — they are notes, e.g. school-free days, not statutory public holidays. Date-based tools skip them.
  • Years 1900–2100 are accepted; the API serves historical and future calendars.
  • feiertage_holidays_between fetches one request per year in the range (max ~2 years).

Built by Mohammad Abbasi — Almanibama · mabbasi.ir

来源:README.md,提交 c71caa1

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.0最新Nov 14, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分