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 個聯邦州代碼與全國性假日集合,並檢查 API 是否可連線
適用情境
適合助理需要可靠的德國假日日期來回答排程、截止期限或營業時間問題,或需要依特定聯邦州的地區性假日做安排時使用。
執行需求
透過 stdio 在本機執行,通常以 uvx 或 python -m 啟動 PyPI 套件;需要 Python 與 mcp、httpx 相依套件,並能連線至 feiertage-api.de 服務。不需金鑰或登入。
安裝前請注意
屬非官方專案,與 feiertage-api.de 及 bundesAPI 專案無關,用於法律或官方用途前應自行查證。雖為唯讀,但每次查詢都會送往第三方 API;部分項目僅為放假說明(如學校假期),並非法定國定假日。

安裝

在 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 分