jp-dates MCP Server 🗾📅

日本の祝日・和暦・日付情報を Claude に提供する MCP (Model Context Protocol) サーバーです。

An MCP server that gives Claude accurate knowledge of Japanese national holidays, wareki (era) conversion, and date info. Works fully offline — no API keys required.

✨ できること / Features

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

• 「来月の祝日はいつ?」
• 「次の連休まであと何日?」
• 「令和6年って西暦何年?」「1989年1月7日は昭和?平成?」
• 「2026年のシルバーウィークはいつ?」

ツール	説明
jp_list_holidays	指定年(月)の祝日一覧。振替休日・国民の休日も含む
jp_date_info	日付の曜日・祝日判定・和暦表記
jp_convert_era	和暦⇔西暦の相互変換(明治〜令和)
jp_next_holiday	次の祝日と残り日数

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

🚀 セットアップ / Setup

1. インストール

git clone https://github.com/h-kazuki-pixel/jp-dates-mcp-server.git
cd jp-dates-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-dates": {
      "command": "node",
      "args": ["/absolute/path/to/jp-dates-mcp-server/dist/index.js"]
    }
  }
}

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

3. 使ってみる

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

「今年の残りの祝日を教えて」 「昭和58年は西暦何年?」

🧪 動作確認 / Testing

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

npx @modelcontextprotocol/inspector node dist/index.js

📝 祝日計算について / Notes

• 祝日は法律(国民の祝日に関する法律)のルールに基づきアルゴリズムで算出しています
• 春分・秋分は天文計算の近似式を使用(1980〜2099年で有効)
• 将来の法改正には追従が必要です。誤りを見つけたら Issue で教えてください!

🤝 コントリビュート / Contributing

Issue・Pull Request 歓迎です! 機能要望(六曜、旧暦、営業日計算など)もお待ちしています。

📄 License

MIT