PlugRail Japanese Calendar

by plugrail

342 downloads
Not rated
GitHub

About

Japanese holiday and business-day calculations using official Japan Cabinet Office data.

Details

Author
plugrail
Downloads
342
Categories
Developer Tools, Remote MCP

- MCP server integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name PlugRail Japanese Calendar
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Follow the repository README to install the server and add its MCP configuration to your client.

is_holiday

指定した日付が日本の祝日(国民の祝日・休日)かどうかを判定します。内閣府公表データに基づきます。入力例: {"date": "2026-01-01"}

list_holidays

指定した年または期間の日本の祝日一覧を返します。入力例: {"year": 2026} または {"from": "2026-01-01", "to": "2026-06-30"}

add_business_days

指定した日付(date)の翌日から数えてN営業日目(days)の日付を返します。dateの当日は数えません。daysが負の場合は過去方向(dateの前日から遡ってN営業日目)に計算します。土日・日本の祝日を除外し、calendar="banking"を指定すると銀行休業日(12/31〜1/3)も除外します。dateが営業日かどうかだけ知りたい場合は is_holiday を使ってください(days=0でも同じ情報がskipped経由で得られます)。入力例: {"date": "2026-07-10", "days": 3}

business_days_between

from〜to間の営業日数を数えます。既定では「fromを含まず、toを含む」境界です(例:「今日から支払期日まで何営業日か」)。include_from/include_toで境界を変更できます。土日・日本の祝日を除外し、calendar="banking"を指定すると銀行休業日(12/31〜1/3)も除外します。from > to の場合はエラーにせず、from/toとinclude_from/include_toを入れ替えて計算した結果の符号を反転した値(負の営業日数)を返します(反対称則: count(A,B,x,y) = -count(B,A,y,x)。A≠B、すなわちfrom≠toの場合に成立する恒等式で、from===toはこの分岐に入らないため対象外)。入力例: {"from": "2026-07-10", "to": "2026-07-20"}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "plugrail japanese calendar": {
            "jp-calendar": {
                "url": "https://jp-calendar.plugrail.dev/mcp"
            }
        }
    }
}

McpServers

{
    "jp-calendar": {
        "url": "https://jp-calendar.plugrail.dev/mcp"
    }
}
# plugrail [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-server-blue.svg)](https://modelcontextprotocol.io/) A collection of MCP servers that connect to Japanese public data. The name alone does not describe the project, so plugrail is not related to railways or railway services. ## Live servers | Server | MCP endpoint | Tools | Status | | --- | --- | --- | --- | | jp-calendar | `https://jp-calendar.plugrail.dev/mcp` | `is_holiday`, `list_holidays`, `business_days_between`, `add_business_days` | Live | ## Connect See [the jp-calendar connection guide](docs/servers/jp-calendar/CONNECT.md). ## Self-hosting 1. In `packages/servers/jp-calendar/`, copy `wrangler.example.jsonc` to `wrangler.jsonc` and fill in your Cloudflare resource IDs. 2. Create the D1 database and KV namespace referenced by that configuration. 3. Run `pnpm --filter @plugrail/jp-calendar deploy`. The self-hosted server runs independently. Authentication, rate limiting, and usage metering are features of the hosted service only. ## Architecture ```text MCP client | v jp-calendar Worker --> Cloudflare D1 (holiday data) --> Cloudflare KV (cached data) ``` ## Sources and disclaimer This is not an official service of the National Tax Agency, the Digital Agency, or any other Japanese government body. Information provided does not represent their official views and is not guaranteed by them. Source: Adapted from the Cabinet Office "National Holidays" page (https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html) ## Contributing Issues and pull requests are welcome. Please include enough context to reproduce a problem or explain a proposed change. ## License MIT. See [LICENSE](LICENSE).
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.