japan-business-calendar-mcp

日本の営業日・祝日計算 MCP

AI エージェントに日本の公式な国民の祝日と営業日の計算機能を提供する 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
• ライセンス：政府標準利用規約（出典明示で商用利用可）
• 対象期間：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 経由でインストール

次の 1 つのコマンドで、この 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をご覧ください。