Jp Dates 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