jp-business-days MCP Server 📅✅

日本の営業日計算(土日・祝日を除く)を Claude に提供する MCP (Model Context Protocol) サーバーです。

An MCP server that gives Claude accurate Japanese business-day calculations (weekends and national holidays excluded). Works fully offline — no API keys required.

jp-series の第2弾です。第1弾の jp-dates-mcp-server(祝日・和暦)と組み合わせて使うと、より便利になります。

✨ できること / Features

Claude にこんな質問が正確に即答できるようになります:

• 「今日は営業日?」
• 「今日から5営業日後は何日?」
• 「今月と来月の間で、営業日は何日ある?」
• 「9月30日が期限の書類、10営業日前までに準備するなら、いつまでに動けばいい?」

ツール	説明
jp_is_business_day	指定日が営業日(平日かつ祝日でない)かどうかを判定
jp_add_business_days	指定日からN営業日後・前の日付を計算
jp_business_days_between	2つの日付の間(両端含む)の営業日数をカウント
jp_calc_deadline	基準日(有効期限・締切日など)からN営業日前の「対応期限日」を逆算

• ✅ APIキー不要・完全オフライン(祝日はアルゴリズムで算出)
• ✅ 振替休日・国民の休日・2020/2021年の五輪特例に対応
• ✅ 対応範囲: 2020〜2099年

💡 jp_calc_deadline の使いどころ

許認可の更新、契約の更新、各種届出など、「期限のX営業日前までに提出・対応する」という管理が必要な場面で使えます。土日・祝日を挟んでも、実際に動ける営業日ベースで正確に逆算します。

🚀 セットアップ / Setup

1. インストール

git clone https://github.com/h-kazuki-pixel/jp-business-days-mcp-server.git
cd jp-business-days-mcp-server
npm install
npm run build

2. Claude Desktop に登録

claude_desktop_config.json に以下を追加します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jp-business-days": {
      "command": "node",
      "args": ["/absolute/path/to/jp-business-days-mcp-server/dist/index.js"]
    }
  }
}

Claude Desktop を再起動すると、🔌アイコンからツールが確認できます。

3. 使ってみる

Claude にそのまま話しかけるだけです:

「今日から10営業日後はいつ?」 「8月31日が期限なら、10営業日前はいつまでに動けばいい?」

🧪 動作確認 / Testing

MCP Inspector で対話的にテストできます:

npx @modelcontextprotocol/inspector node dist/index.js

リポジトリ同梱の統合テスト(4つのツールをすべて実行して検証)も実行できます:

npm run build
node test/run_tests.mjs

📝 営業日計算について / Notes

• 祝日は法律(国民の祝日に関する法律)のルールに基づきアルゴリズムで算出しています(jp-dates-mcp-serverと同じロジック)
• 「営業日」は「祝日でない平日(月〜金)」として計算しています。会社独自の休業日(夏季休業・年末年始休業など)は含まれません
• 将来の法改正には追従が必要です。誤りを見つけたら Issue で教えてください!

🤝 コントリビュート / Contributing

Issue・Pull Request 歓迎です!

📄 License

MIT