English Français العربية

io.github.atushi1841/japan-business-calendar-mcp

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

MCPB package https://github.com/atushi1841/japan-business-calendar-mcp/releases/download/v0.1.0/server.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Japan Business Day & Holiday Calculator MCP
  2. What it does
  3. Data & attribution
  4. Local run
  5. Deployment
  6. Apify Store
  7. Install via Smithery
  8. MCP Registry

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

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

الأسئلة الشائعة

ما هو io.github.atushi1841/japan-business-calendar-mcp؟

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

كيف أثبّت io.github.atushi1841/japan-business-calendar-mcp؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل يحتاج io.github.atushi1841/japan-business-calendar-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.atushi1841/japan-business-calendar-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.atushi1841/japan-business-calendar-mcp؟

ينشره atushi1841. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.