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 分

    请在仓库或注册中心条目中声明许可证。