# JP Business Calendar MCP — 日本のビジネスカレンダー MCP

[![PyPI](https://img.shields.io/pypi/v/jp-business-calendar-mcp)](https://pypi.org/project/jp-business-calendar-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/jp-business-calendar-mcp)](https://pypi.org/project/jp-business-calendar-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

AIアシスタント（Claude Desktop等）から使える、**日本の実務に特化したカレンダーMCPサーバー**です。
祝日判定・営業日計算・支払サイト計算・年度・締切までの残日数を、会話の中でそのまま実行できます。外部API・ログイン不要、すべてローカルで完結します。

## ツール（6種・すべて動作検証済み）
| ツール | 内容 |
|---|---|
| `is_holiday` | 指定日が日本の祝日・休日か（**振替休日・国民の休日**も含む） |
| `next_business_day` | n営業日後（土日祝を除く／負数で過去方向も） |
| `business_days_between` | 期間の営業日数 |
| `payment_date` | 締め日＋支払サイトから**支払日**を計算（休業日は前/翌営業日に調整） |
| `fiscal_year` | 年度（既定4月始まり） |
| `days_until` | 指定日までの残り日数・営業日数（締切管理） |

祝日は固定日・ハッピーマンデー・**春分/秋分（天文計算）**・振替休日・国民の休日まで自動算出します。

## 導入
**PyPIから（推奨・最短）**
```
pip install jp-business-calendar-mcp
```
→ `jp-business-calendar-mcp` コマンドが使えます。

**ソースから（開発）**
```
git clone https://github.com/panda-studio-dev/jp-business-calendar-mcp
cd jp-business-calendar-mcp && pip install -e .
```

## Claude Desktop 設定
`claude_desktop_config.json` に追記：
```json
{ "mcpServers": { "jp-business-calendar": { "command": "jp-business-calendar-mcp" } } }
```
（ソースから動かす場合は `"command": "python3", "args": ["/絶対パス/server.py"]`）

## 使用例
- 「2026年5月6日は祝日？」→ 振替休日
- 「今日から10営業日後は？」
- 「7/15請求、月末締め翌月末払いの支払日は？」→ 2026-08-31
- 「2026年3月31日は何年度？」→ 2025年度

## ライセンス / 免責
MIT License。個人・商用利用可。祝日・営業日は一般的なルールに基づく補助であり、正確性を保証しません。重要な判断は公式のカレンダー等でご確認ください。

## 関連
- GitHub: https://github.com/panda-studio-dev/jp-business-calendar-mcp
- 姉妹版: **[JP Invoice & Tax MCP](https://pypi.org/project/jp-invoice-tax-mcp/)**（消費税・源泉徴収・インボイス番号検証）

---
made by **panda studio** ・ 「JP Invoice & Tax MCP」と合わせて日本のフリーランス/中小の実務MCPスイート