Atlas / MCP servers / plugrail / plugrail-jp-calendar

plugrail-jp-calendarSAFE

Name: plugrail-jp-calendar
Author: plugrail

mcp/plugrail/servers

MCP server by plugrail · Audited 2026-10-11

⚑ Report / re-scan Source ↗

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

Verdict

SAFE

Grade

Trust score

85 /100

Exposed tools

4 3r · 1w · 0d

Transport

streamable-http

License

MIT

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](LICENSE) [](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

Connect

See the jp-calendar connection guide.

Self-hosting

In packages/servers/jp-calendar/, copy wrangler.example.jsonc to wrangler.jsonc and fill in your Cloudflare resource IDs.
Create the D1 database and KV namespace referenced by that configuration.
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

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.

Read from source at commit 675e654e3e1dOBSERVED · 2026-10-11

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add jp-calendar --env ADMIN_TOKEN=${ADMIN_TOKEN} -- npx -y @plugrail/[email protected]

claude-desktop

{
  "mcpServers": {
    "jp-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@plugrail/[email protected]"
      ],
      "env": {
        "ADMIN_TOKEN": "${ADMIN_TOKEN}"
      }
    }
  }
}

Exposed tools (4)

3 read · 1 write · 0 destructive.

Tool	Risk	Description
`add_business_days`	write	指定した日付(date)の翌日から数えてN営業日目(days)の日付を返します。dateの当日は数えません。
`business_days_between`	read	from〜to間の営業日数を数えます。既定では「fromを含まず、toを含む」境界です
`is_holiday`	read	指定した日付が日本の祝日(国民の祝日・休日)かどうかを判定します。内閣府公表データに基づきます。
`list_holidays`	read	指定した年または期間の日本の祝日一覧を返します。

Trust audit

SAFEgrade B · trust 85/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	WARN
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: none-observed
Network: declared (6 observation(s))
Shell: none-observed
Dependencies: not all pinned
Secrets in source: none-found

Findings (17)

MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319

packages/servers/jp-calendar/scripts/ingest-local.mjs:23

const BASE_URL = process.env.WRANGLER_DEV_URL ?? "http://127.0.0.1:8787";

LOWInventory / provenance · inv.hidden_file · CWE-1104

packages/servers/jp-calendar/.dev.vars.example

.dev.vars.example

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

packages/servers/jp-calendar/test/ingest/admin-route.test.ts:3

import { handleAdminIngest } from "../../src/ingest/admin-route.js";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

packages/servers/jp-calendar/test/ingest/csv.test.ts:2

import { parseCsv, toIsoDate } from "../../src/ingest/csv.js";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

packages/servers/jp-calendar/test/ingest/diff.test.ts:2

import { diffHolidays, isEmptyDiff } from "../../src/ingest/diff.js";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

packages/servers/jp-calendar/test/ingest/fetch-mock.ts:5

import { CAO_CSV_URL } from "../../src/ingest/fetch-source.js";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

packages/servers/jp-calendar/test/ingest/notify.test.ts:3

import { notify } from "../../src/ingest/notify.js";