jp-dates MCP Server

jp-dates MCP Server

Provides Japanese national holidays, wareki (era) conversion, and date information. Works fully offline with no API keys required.

Category
Visit Server

README

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured