关于 japan-business-calendar-mcp
japan-business-calendar-mcp 是用于查询日本法定节假日和计算营业日的 MCP 服务。它使用内阁府数据副本离线运行,并按周末及法定节假日不算营业日的规则计算。
主要功能
- 01判断日期类别并查找邻近营业日
- 02计算日期范围内的营业日数量
- 03查找某日期前后第 n 个营业日
- 04按年份列出法定节假日
- 05列出某月的营业日
- 06显示数据来源、许可证和覆盖范围
适用场景
- 01确认某日是否为日本营业日
- 02计算两个日期之间的工作日
- 03查找截止日期或下一个营业日
- 04查看某年的法定节假日
MCP 相关
提供六个工具,用于日期分析、营业日计算、节假日与营业日列表及数据元信息。README 说明可通过 stdio 使用 MCP,也提供 Apify 托管端点。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
日本营业日与节假日计算器 MCP
向 AI Agent 提供日本官方国家法定节假日和营业日计算的 MCP 服务。数据来自内阁府官方的国民の祝日・休日列表——结果确定、可离线使用,运行时无需联网。
功能
| 工具 | 描述 |
|---|---|
analyze_date | 日期是营业日、国家法定节假日还是周末?查找最近的营业日。 |
count_business_days | 计算日期范围内(含首尾)的营业日天数。 |
next_business_day | 查找某日期之前或之后第 n 个营业日。 |
list_holidays | 完整的国家法定节假日列表,可按年份筛选。 |
list_business_days | 列出日本日历月份中的所有营业日。 |
data_summary | 种子数据元信息:来源、许可证、覆盖范围。 |
REST 镜像(OpenAPI):/rest/analyze、/rest/count、/rest/next、
/rest/holidays、/rest/business-days、/rest/summary、/health、/openapi.json。
数据与来源说明
- 来源:内阁府(内閣府)国民の祝日・休日 — https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv
- 许可证:Government Standard Terms of Use(注明出处即可商用)
- 覆盖范围:1955-01-01 → 2027-11-23(1,067 个节假日),随附于
data/japan_holidays.json(约 63 KB)。 - 营业日规则:不是国家法定节假日,且不是周六或周日。
本地运行
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
部署
Apify Actor japan-business-calendar-mcp(待机模式,
webServerMcpPath=/mcp、Dockerfile CMD ["python", "-m", "src.main"]):
https://fruitful-quintessence--japan-business-calendar-mcp.apify.actor/mcp
Apify Store
此 MCP 服务也可作为托管 Apify Actor 使用(PPE 付费):
- Apify Store:japan-business-calendar-mcp — 提供来自内阁府官方列表的日本营业日和国家法定节假日数据。可从 Apify Store 运行(点击 Run 按钮),然后将 MCP 客户端指向该端点。
通过 Smithery 安装
只需一条命令,即可将此 MCP 服务连接到 AI 客户端(Claude Desktop、Cursor、VS Code):
npx @smithery/cli install atushi1841/japan-business-calendar-mcp --client claude
对于其他客户端,请将 claude 替换为 cursor、vscode 或 cline。
也可以直接从 Smithery 注册表安装。
MCP 注册表
此服务已在官方 MCP 注册表中注册。 可通过搜索找到:japan-business-calendar-mcp
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。