Japan Business Calendar Mcp

io.github.atushi1841由 GitHub 帳號 atushi1841 發布v0.1.0更新於 Oct 29, 2026

Japan business day & holiday calculator MCP. Official holidays + business-day arithmetic, 6 tools.

已驗證STDIO僅桌面位置與生活效率與工作流

概覽

AI 產生的概覽

離線 MCP 伺服器，讓助理取得日本國定假日資料與工作日計算，涵蓋 1955 年至 2027 年。

可以做什麼
  • 判斷某日期是工作日、國定假日或週末，並找出最近的工作日
  • 計算日期區間內的工作日數，或往前／往後推算第 n 個工作日
  • 列出全部國定假日（可依年份篩選），並列出某個月份的所有工作日
  • 說明內建資料的來源、授權與涵蓋範圍
適用情境
適合在排程、截止日或交期需要依日本工作日判斷時使用，例如避開黃金週或年末年始安排計畫，或確認某個日期在日本是否為上班日。
執行需求
以本機程序執行（stdio），README 範例以 uv run 啟動。假日資料已內建，執行時不需網路、帳號或 API 金鑰。僅支援桌面用戶端。
安裝前請注意
假日資料為內建快照，涵蓋 1955-01-01 至 2027-11-23，超出範圍或之後的官方調整不會反映。工作日僅以「非假日且非週末」判定，不考慮企業自訂行事曆。README 另提到付費的 Apify 託管版本，本機套件本身不需付費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Japan Business Calendar Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Japan Business Day & Holiday Calculator MCP

MCP server exposing Japan's official national holidays and business-day arithmetic to AI agents. Data is the Cabinet Office (内閣府) official 国民の祝日・休日 list — deterministic, offline-safe, no network at runtime.

What it does

ToolDescription
analyze_dateIs a date a business day, a national holiday, or a weekend? Nearest business days.
count_business_daysInclusive business-day count over a date range.
next_business_dayn-th business day before/after a date.
list_holidaysFull national holiday list, optionally filtered by year.
list_business_daysAll business days in a Japanese calendar month.
data_summarySeed metadata: source, license, coverage.

REST mirror (OpenAPI): /rest/analyze, /rest/count, /rest/next, /rest/holidays, /rest/business-days, /rest/summary, /health, /openapi.json.

Data & attribution

  • Source: Cabinet Office (内閣府) 国民の祝日・休日 — https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv
  • License: Government Standard Terms of Use (出典明示で商用利用可)
  • Coverage: 1955-01-01 → 2027-11-23 (1,067 holidays), bundled as data/japan_holidays.json (~63 KB).
  • Business-day rule: not a national holiday and not Saturday/Sunday.

Local run

bash
uv run --directory . src/stdio_main.py        # stdio MCP (Claude Desktop / Cursor)JBC_DATA_DIR=. python3 tests/test_jbc.py       # smoke: 6 MCP tools + 8 REST endpoints

Deployment

Apify Actor japan-business-calendar-mcp (Standby mode, webServerMcpPath=/mcp, Dockerfile CMD ["python", "-m", "src.main"]): https://fruitful-quintessence--japan-business-calendar-mcp.apify.actor/mcp

Apify Store

This MCP server is also available as a managed Apify Actor (PPE课金):

  • Apify Store: japan-business-calendar-mcp — Japanese business days & national holidays from the Cabinet Office official list. Run from the Apify Store (Run button), then point your MCP client at the endpoint.

Install via Smithery

Connect this MCP server to your AI client (Claude Desktop, Cursor, VS Code) in one command:

bash
npx @smithery/cli install atushi1841/japan-business-calendar-mcp --client claude

Replace claude with cursor, vscode, or cline for other clients.

Alternatively, install directly from the Smithery registry.

MCP Registry

This server is registered on the official MCP Registry. Find it via search: japan-business-calendar-mcp

來源：README.md，提交 64cfd28

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Oct 29, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。