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営業日前までに準備するなら、いつまでに動けばいい?」

• ✅ APIキー不要・完全オフライン(祝日はアルゴリズムで算出)

• ✅ 振替休日・国民の休日・2020/2021年の五輪特例に対応

• ✅ 対応範囲: 2020〜2099年

💡 jp_calc_deadline の使いどころ

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

Related MCP server: JP Business Calendar MCP

🚀 セットアップ / 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