Server data from the Official MCP Registry
Japan business day & holiday calculator MCP. Official holidays + business-day arithmetic, 6 tools.
About
Japan business day & holiday calculator MCP. Official holidays + business-day arithmetic, 6 tools.
Security Report
This is a read-only Japanese holiday and business-day calculator that uses a bundled offline seed and makes no outbound network calls at runtime, so its permissions match its purpose. The findings are minor: the REST layer is unauthenticated (acceptable for public data) and binds to 0.0.0.0, the developer-only packing script runs git push and gh release upload, an unused httpx dependency is declared, and there are small code-quality issues such as a duplicated analyze call and a dead loop in _parse_date. Supply chain analysis found 13 known vulnerabilities in dependencies (1 critical, 6 high severity).
13 files analyzed · 19 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-atushi1841-japan-business-calendar-mcp": {
"args": [
"japan-business-calendar-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
| Tool | Description |
|---|---|
analyze_date | Is a date a business day, a national holiday, or a weekend? Nearest business days. |
count_business_days | Inclusive business-day count over a date range. |
next_business_day | n-th business day before/after a date. |
list_holidays | Full national holiday list, optionally filtered by year. |
list_business_days | All business days in a Japanese calendar month. |
data_summary | Seed 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
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:
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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Lharries · Communication
Read, search, and send WhatsApp messages through your AI assistant