@first-ch/tools-mcp 0.31.0 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @first-ch/tools-mcp
2
2
 
3
- MCP server exposing [First CH Tools](https://tools.first-ch.com)' free web-tool logic — WCAG contrast, JP character/X-weight counting, WebP conversion, JSON-LD generation, llms.txt generation, encoding/line-ending conversion, Marp Markdown→slide rendering, Japanese/English test-data generation, text/code diffing, cron-expression explanation, Base64/data-URI encoding, URL query-parameter editing, HTML entity escaping/unescaping, JSON⇄YAML conversion, px ⇄ rem/em unit conversion, colour-code conversion with alpha compositing, MD5/SHA-1/SHA-256/SHA-384/SHA-512 hashing, JWT decoding with expiry and signature checks, User-Agent parsing with device/bot detection, bulk UUID v4 / ULID generation, aspect-ratio calculation with responsive sizing, case conversion between camelCase, snake_case and kebab-case, CSV/TSV ⇄ JSON conversion, IP/CIDR calculation with subnet splitting and IP-range reduction, business-day date calculation with Japanese public holidays, and HTML-to-Markdown conversion — to AI agents such as Claude Code.
3
+ MCP server exposing [First CH Tools](https://tools.first-ch.com)' free web-tool logic — WCAG contrast, JP character/X-weight counting, WebP conversion, JSON-LD generation, llms.txt generation, encoding/line-ending conversion, Marp Markdown→slide rendering, Japanese/English test-data generation, text/code diffing, cron-expression explanation, Base64/data-URI encoding, URL query-parameter editing, HTML entity escaping/unescaping, JSON⇄YAML conversion, px ⇄ rem/em unit conversion, colour-code conversion with alpha compositing, MD5/SHA-1/SHA-256/SHA-384/SHA-512 hashing, JWT decoding with expiry and signature checks, User-Agent parsing with device/bot detection, bulk UUID v4 / ULID generation, aspect-ratio calculation with responsive sizing, case conversion between camelCase, snake_case and kebab-case, CSV/TSV ⇄ JSON conversion, IP/CIDR calculation with subnet splitting and IP-range reduction, business-day date calculation with Japanese public holidays, HTML-to-Markdown conversion, and Japanese era ⇄ Western date conversion with age calculation — to AI agents such as Claude Code.
4
4
 
5
5
  日本語版は [後半セクション](#日本語) を参照してください。
6
6
 
@@ -80,6 +80,8 @@ This server is also registered in the [MCP Registry](https://registry.modelconte
80
80
 
81
81
  | `html_to_markdown` | Converts an HTML fragment into Markdown — the same logic as the browser tool at tools.first-ch.com/html-md/. For turning a fetched page into something an LLM can read cheaply, and for moving existing web copy into Markdown. Headings (h1-h6), paragraphs, line breaks, emphasis, strikethrough, lists (nested, the `start` attribute, checkboxes), tables (thead / caption, with column alignment taken from `align` and `text-align`), links, images, code blocks (the language comes from `class="language-*"`), block quotes, horizontal rules, definition lists, figure / figcaption and details / summary are all handled, while `script`, `style`, anything marked `hidden` or `display:none` and presentational `div` / `span` wrappers are removed. **The HTML is not parsed with the browser DOM**: the tokeniser and tree builder are written by hand, so this server and the web page agree exactly, and unclosed elements are closed at the end while stray closing tags are dropped — the counts always come back in `notes`. **An attribute quote that is never closed stops the tag there**, because carrying on would swallow the rest of the document as one attribute value. **Whatever Markdown cannot express is reported rather than dropped in silence**: merged cells (a `colspan` is padded with empty cells, a `rowspan` keeps its value on the first row only), a cell holding a list or a code block (that table is left as HTML), definition lists (written in the Markdown Extra `: ` form) and `sup` / `sub` / `mark` / `iframe` / `svg` (`unknown` chooses between keeping them as HTML, reducing them to text and removing them). Tables, task lists and strikethrough are GFM extensions, so `gfm=false` switches them off. `base_url` rewrites relative links and images as absolute URLs — the thing that breaks most often in a migration — and `main_only` keeps only `main` / `article`, dropping `header`, `nav`, `footer`, `aside` and `form`. It never touches the network; fetching the page is the caller's job | `html?` or `path?`, `outputPath?`, `main_only?`, `base_url?`, `gfm?`, `escape?`, `pad_tables?`, `headings?` (`atx` default / `setext`), `bullet?` (`-` / `*` / `+`), `code_block?` (`fenced` / `indented`), `links?` (`inline` / `reference` / `strip`), `images?` (`keep` / `alt` / `drop`), `tables?` (`gfm` / `html`), `unknown?` (`keep` / `text` / `drop`), `br?` (`spaces` / `backslash` / `html` / `space`), `lang?` (`ja` default / `en`) |
82
82
 
83
+ | `wareki_convert` | Converts Japanese era dates (Reiwa, Heisei, Showa, Taisho, Meiji) and Western dates both ways and returns the weekday and zodiac — the same logic as the browser tool at tools.first-ch.com/wareki/. For converting and checking the dates in contracts, invoices and official forms. `mode="convert"` takes `date` or `dates` (up to 1000) and **detects which calendar each one is in**: `2026-10-01`, `2026/10/1`, `20261001`, `2026年10月1日`, `令和8年10月1日`, `R8.10.1`, `令和八年十月一日`, `㋿8.10.1`, `Reiwa 8` and so on. A year alone (`1989`, `昭和64年`) or a year and month (`2019-05`) also works, and both eras are returned when the period spans an era change. `formats` gives the era date (gannen, with weekday, in kanji numerals), the short forms (`R8.10.1` / `R08.10.01`), Western, ISO 8601 and English. Eras begin on 1912-07-30 (Taisho), 1926-12-25 (Showa), 1989-01-08 (Heisei) and 2019-05-01 (Reiwa). **Era dates that never existed (Heisei 32, Heisei 31 May 1, Reiwa 1 April 30) are still converted, and `notes` gives the correct era date**; a written weekday that does not match comes back as `WEEKDAY_MISMATCH`. **Before 1873 (Meiji 5 and earlier) only the year is converted**, because dates were lunisolar (`LUNAR_CALENDAR`). `mode="age"` takes `birth` (era dates accepted) and `reference` (today in Japan time if omitted) and returns the exact age (it goes up on the birthday; people born on February 29 turn older on March 1 in common years), years/months/days, the kazoe age, the next birthday and the entry and graduation years from elementary school to university. `mode="eras"` returns the era list, plus a year chart of era, zodiac and age when `from_year` / `to_year` are given (up to 500 years). Badly written dates come back as `ok: false` with `error.code` | `mode?` (`convert` / `age` / `eras`), `date?`, `dates?`, `birth?`, `reference?`, `from_year?`, `to_year?`, `lang?` (`ja` default / `en`) |
84
+
83
85
  See [`server.mjs`](./server.mjs) for the exact Zod input schemas.
84
86
 
85
87
  **PDF output (`marp_render`) needs a local Chrome/Chromium.** marp-core renders the HTML with no browser dependency (so the package stays light for `npx`); PDF is produced by driving a locally-installed Chrome/Chromium in headless mode. It is auto-detected on common paths, or set `MARP_CHROME_PATH` to the executable. If none is found, `marp_render` returns the HTML only and reports `pdf_skipped` — you can still open that HTML and print → PDF yourself (one slide per page).
@@ -123,7 +125,7 @@ Release rule: a push to `main` automatically publishes a new package version thr
123
125
 
124
126
  ## 日本語
125
127
 
126
- `@first-ch/tools-mcp` は、[First CH Tools](https://tools.first-ch.com)(無料Webツール集)の計算ロジック — WCAGコントラスト比・日本語文字数/Xウェイト計測・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/編集/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4 / ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・camelCase / snake_case / kebab-case などの文字列ケース変換・CSV/TSV ⇄ JSON の相互変換・日数/営業日の計算(日本の祝日を内蔵)・HTML→Markdownの変換 — をAIエージェント(Claude Code等)向けMCPツールとして提供するサーバーです。
128
+ `@first-ch/tools-mcp` は、[First CH Tools](https://tools.first-ch.com)(無料Webツール集)の計算ロジック — WCAGコントラスト比・日本語文字数/Xウェイト計測・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/編集/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4 / ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・camelCase / snake_case / kebab-case などの文字列ケース変換・CSV/TSV ⇄ JSON の相互変換・日数/営業日の計算(日本の祝日を内蔵)・HTML→Markdownの変換・和暦⇄西暦の変換と満年齢の計算 — をAIエージェント(Claude Code等)向けMCPツールとして提供するサーバーです。
127
129
 
128
130
  ### インストール
129
131
 
@@ -201,6 +203,8 @@ claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp
201
203
 
202
204
  | `html_to_markdown` | HTML断片をMarkdownへ変換する。tools.first-ch.com/html-md/ と同一ロジック。取得したページの本文をLLMへ渡す前の後処理、既存サイトの原稿をMarkdown管理へ移す移行作業のための道具。見出し(h1〜h6)・段落・改行・強調・取り消し線・リスト(入れ子・`start` 属性・チェックボックス)・表(thead / caption と `align`・`text-align` による列の配置)・リンク・画像・コードブロック(`class="language-*"` から言語を拾う)・引用・水平線・定義リスト・figure / figcaption・details / summary に対応し、`script`・`style`・`hidden` や `display:none` の要素・装飾のための `div` / `span` は自動で取り除く。**HTMLの解釈にブラウザのDOMを使っていない**——字句解析も木の組み立ても自前なのでWeb版と結果が一致し、閉じ忘れたタグは末尾で閉じ、行き場のない閉じタグは捨てて変換を続ける(補った件数は必ず `notes` で返す)。**属性の引用符が閉じていない場合だけは打ち切る**——続けると残りの文書全体を1つの属性値として飲み込むため。**Markdownに書けないものは黙って捨てず報告する**: セルの結合(`colspan` は空セルで埋め、`rowspan` は先頭行にだけ値が入る)・セル内のリスト/コードブロック(その表だけHTMLのまま残す)・定義リスト(Markdown Extra の `: ` 記法)・`sup` / `sub` / `mark` / `iframe` / `svg`(`unknown` で「HTMLのまま残す/文字だけ残す/取り除く」を選ぶ)。表・タスクリスト・取り消し線はGFMの拡張なので `gfm=false` で切れる。`base_url` を渡すと相対URLのリンクと画像を絶対URLへ直し(移行でいちばん壊れるところ)、`main_only=true` は `main` / `article` の中だけを取り出して `header`・`nav`・`footer`・`aside`・`form` を落とす。ネットワークへは出ない(ページの取得は呼び出し側の仕事) | `html?` または `path?`、`outputPath?`、`main_only?`、`base_url?`、`gfm?`、`escape?`、`pad_tables?`、`headings?`(既定 `atx` / `setext`)、`bullet?`(`-` / `*` / `+`)、`code_block?`(`fenced` / `indented`)、`links?`(`inline` / `reference` / `strip`)、`images?`(`keep` / `alt` / `drop`)、`tables?`(`gfm` / `html`)、`unknown?`(`keep` / `text` / `drop`)、`br?`(`spaces` / `backslash` / `html` / `space`)、`lang?`(既定 `ja` / `en`) |
203
205
 
206
+ | `wareki_convert` | 和暦(令和・平成・昭和・大正・明治)と西暦を相互に変換し、曜日と干支を返す。tools.first-ch.com/wareki/ と同一ロジック。契約書・請求書・行政書類の日付の変換と検算のための道具。`mode="convert"` は `date` か `dates`(1000件まで)を受け、**西暦か和暦かを自動で見分ける**(`2026-10-01`・`2026/10/1`・`20261001`・`2026年10月1日`・`令和8年10月1日`・`R8.10.1`・`令和八年十月一日`・`㋿8.10.1`・`Reiwa 8` など)。年だけ(`1989`・`昭和64年`)・年月だけ(`2019-05`)も変換でき、改元をまたぐときは両方の元号を返す。`formats` に和暦(元年表記・曜日つき・漢数字)・略記(`R8.10.1`/`R08.10.01`)・西暦・ISO 8601・英語を返す。**存在しない和暦(平成32年・平成31年5月1日・令和元年4月30日)も西暦へ直したうえで正しい和暦を `notes` で指摘**し、書き添えの曜日が実際と違えば `WEEKDAY_MISMATCH` を返す。**明治5年(1872年)以前は旧暦のため年単位でだけ換算する**(`LUNAR_CALENDAR`)。`mode="age"` は `birth`(和暦可)と `reference`(省略時は日本時間の今日)から満年齢(誕生日に1つ増え、2月29日生まれは平年だと3月1日)・年月日の内訳・数え年・次の誕生日と、小学校〜大学の入学・卒業の年を返す。`mode="eras"` は元号一覧を返し、`from_year` / `to_year` を渡すと和暦・干支・満年齢の早見表も返す(500年分まで)。日付の書き方の誤りは `ok: false` と `error.code` で返す | `mode?`(`convert` / `age` / `eras`)、`date?`、`dates?`、`birth?`、`reference?`、`from_year?`、`to_year?`、`lang?`(既定 `ja` / `en`) |
207
+
204
208
  正確な入力スキーマ(Zod定義)は [`server.mjs`](./server.mjs) を参照してください。
205
209
 
206
210
  **`marp_render` のPDF出力にはローカルの Chrome/Chromium が必要です。** marp-core によるHTML生成はブラウザ非依存(`npx` 導入を軽く保つため)で、PDFはローカルインストール済みの Chrome/Chromium を headless で駆動して生成します。定番パスから自動検出し、`MARP_CHROME_PATH` で実行ファイルを明示することもできます。見つからない場合は HTML のみを返し `pdf_skipped` を報告します(そのHTMLを開いて印刷→PDF保存でも1スライド=1ページで作成できます)。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@first-ch/tools-mcp",
3
- "version": "0.31.0",
4
- "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化))をMCPツールとして提供するサーバー",
3
+ "version": "0.32.0",
4
+ "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表))をMCPツールとして提供するサーバー",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"
@@ -179,7 +179,14 @@
179
179
  "html2markdown",
180
180
  "markdown-converter",
181
181
  "web-scraping",
182
- "content-migration"
182
+ "content-migration",
183
+ "wareki",
184
+ "japanese-era",
185
+ "japanese-calendar",
186
+ "reiwa",
187
+ "heisei",
188
+ "showa",
189
+ "age-calculator"
183
190
  ],
184
191
  "author": "First CH LLC (https://first-ch.com)",
185
192
  "homepage": "https://tools.first-ch.com",
@@ -227,6 +234,7 @@
227
234
  "cidr.mjs",
228
235
  "date-calc.mjs",
229
236
  "html-md.mjs",
237
+ "wareki.mjs",
230
238
  "date-holidays.json",
231
239
  "vendor/",
232
240
  "README.md",
package/server.mjs CHANGED
@@ -34,6 +34,7 @@ import { csvConvertTool } from './csv-json.mjs';
34
34
  import { cidrCalcTool } from './cidr.mjs';
35
35
  import { dateCalcTool } from './date-calc.mjs';
36
36
  import { htmlToMarkdownTool } from './html-md.mjs';
37
+ import { warekiConvertTool } from './wareki.mjs';
37
38
 
38
39
  const { version } = createRequire(import.meta.url)('./package.json');
39
40
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -1479,4 +1480,40 @@ server.registerTool(
1479
1480
  },
1480
1481
  );
1481
1482
 
1483
+ server.registerTool(
1484
+ 'wareki_convert',
1485
+ {
1486
+ title: '和暦 ⇄ 西暦変換・満年齢',
1487
+ description:
1488
+ '和暦(令和・平成・昭和・大正・明治)と西暦を相互に変換し、曜日と干支を返す(tools.first-ch.com/wareki/ と同一ロジック)。' +
1489
+ '契約書・請求書・行政書類の日付表記の変換と検算に使う。' +
1490
+ '`mode="convert"` は date(1件)か dates(配列・1000件まで)を受け、**西暦か和暦かを自動で見分ける**: ' +
1491
+ '2026-10-01 / 2026/10/1 / 20261001 / 2026年10月1日 / 令和8年10月1日 / R8.10.1 / 令和八年十月一日 / ㋿8.10.1 / Reiwa 8 など。' +
1492
+ '年だけ(1989・昭和64年)・年月だけ(2019-05)も変換でき、改元をまたぐときは両方の元号を返す。' +
1493
+ '書き方は和暦(元年表記・曜日つき・漢数字)・略記(R8.10.1 / R08.10.01)・西暦・ISO 8601・英語を formats で返す。' +
1494
+ '改元日は大正1912-07-30・昭和1926-12-25・平成1989-01-08・令和2019-05-01。' +
1495
+ '**存在しない和暦(平成32年・平成31年5月1日・令和元年4月30日)も西暦へ直したうえで正しい和暦を notes で指摘**し、' +
1496
+ '書き添えの曜日((金)など)が実際と違えば WEEKDAY_MISMATCH を返す。' +
1497
+ '**明治5年(1872年)以前は旧暦のため年単位でだけ換算する**(LUNAR_CALENDAR)。' +
1498
+ '`mode="age"` は birth(和暦可)と reference(省略時は日本時間の今日)から満年齢(誕生日に1つ増える・2月29日生まれは平年だと3月1日)・' +
1499
+ '年月日の内訳・数え年・次の誕生日と、小学校〜大学の入学・卒業の年(4月2日〜翌4月1日生まれが同学年・浪人なし)を返す。' +
1500
+ '`mode="eras"` は元号一覧を返し、from_year / to_year を渡すと和暦・干支・満年齢の早見表も返す(500年分まで)。' +
1501
+ '日付の書き方の誤りは ok:false と error.code で返す。日付は通算日の整数で扱うのでサーバーのタイムゾーンで1日ずれない。完全ローカル処理・ネットワーク送信なし。',
1502
+ inputSchema: {
1503
+ mode: z.enum(['convert', 'age', 'eras']).optional().describe('処理の種類(省略時は birth があれば age、date/dates があれば convert、無ければ eras)'),
1504
+ date: z.string().optional().describe('変換する日付1件(西暦でも和暦でも。例: 令和8年10月1日 / 2026-10-01 / R8.10.1 / 昭和60年)'),
1505
+ dates: z.array(z.string()).optional().describe('一括変換する日付の配列(1000件まで。date より優先)'),
1506
+ birth: z.string().optional().describe('mode=age の生年月日(和暦可)'),
1507
+ reference: z.string().optional().describe('mode=age の基準日・mode=eras の年齢の基準(省略時は日本時間の今日)'),
1508
+ from_year: z.number().int().optional().describe('mode=eras で早見表を作る最初の西暦年(1868〜)'),
1509
+ to_year: z.number().int().optional().describe('mode=eras で早見表を作る最後の西暦年(省略時は基準日の年)'),
1510
+ lang: z.enum(['ja', 'en']).optional().describe("曜日・干支の動物名・指摘事項の言語(既定 'ja')"),
1511
+ },
1512
+ },
1513
+ async (opts) => {
1514
+ await logUsage('wareki_convert');
1515
+ return asText(await warekiConvertTool(opts));
1516
+ },
1517
+ );
1518
+
1482
1519
  await server.connect(new StdioServerTransport());
package/wareki.mjs ADDED
@@ -0,0 +1,669 @@
1
+ /* 和暦 ⇄ 西暦変換(wareki_convert)
2
+ * 変換コア(wkParse / wkConvert / wkAge / wkEraList / wkYearTable ほか)は
3
+ * FirstCHTools の site/wareki/app.js と同一
4
+ * (2箇所ルール: site側が正本・片方を直したらもう片方も同じ内容で反映する)。
5
+ * 両ファイルからコアの開始/終了コメントに挟まれた範囲を sed で切り出し
6
+ * (site側は字下げ2文字を落とす・こちらは行頭の export を落とす)、
7
+ * diff が空になることで同期を機械的に確認できる。
8
+ *
9
+ * 日付は Date を使わず「1970-01-01 からの通算日」の整数で扱うので、
10
+ * サーバーのタイムゾーン設定に結果が左右されない(「今日」だけは日本時間で決める)。
11
+ * 完全ローカル処理・ネットワーク送信なし。 */
12
+
13
+ /* ==================== ここから変換コア(site / MCP で同一) ==================== */
14
+
15
+ export class WarekiError extends Error {
16
+ constructor(code, info) {
17
+ super(code);
18
+ this.name = 'WarekiError';
19
+ this.code = code;
20
+ this.info = info || {};
21
+ }
22
+ }
23
+
24
+ /** 明治以降の元号。start / end はグレゴリオ暦の初日・末日(end: null は現在の元号)。
25
+ * 明治の初日は「慶応4年1月1日に遡って明治元年とする」詔(1868年10月23日)に従う。 */
26
+ export const WK_ERAS = [
27
+ { key: 'meiji', name: '明治', kana: 'めいじ', en: 'Meiji', abbr: 'M', start: [1868, 1, 25], end: [1912, 7, 29] },
28
+ { key: 'taisho', name: '大正', kana: 'たいしょう', en: 'Taisho', abbr: 'T', start: [1912, 7, 30], end: [1926, 12, 24] },
29
+ { key: 'showa', name: '昭和', kana: 'しょうわ', en: 'Showa', abbr: 'S', start: [1926, 12, 25], end: [1989, 1, 7] },
30
+ { key: 'heisei', name: '平成', kana: 'へいせい', en: 'Heisei', abbr: 'H', start: [1989, 1, 8], end: [2019, 4, 30] },
31
+ { key: 'reiwa', name: '令和', kana: 'れいわ', en: 'Reiwa', abbr: 'R', start: [2019, 5, 1], end: null },
32
+ ];
33
+
34
+ export const WK_MIN_YEAR = 1868;
35
+ export const WK_MAX_YEAR = 9999;
36
+ /** 改暦(明治5年12月3日=明治6年1月1日)。これより前の和暦の月日は旧暦(天保暦)で、西暦の月日と一致しない */
37
+ export const WK_SOLAR_FROM = [1873, 1, 1];
38
+
39
+ export const WK_WD_JA = ['日', '月', '火', '水', '木', '金', '土'];
40
+ export const WK_WD_EN = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
41
+ export const WK_MONTH_EN = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
42
+ export const WK_STEMS = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
43
+ export const WK_STEM_KANA = ['きのえ', 'きのと', 'ひのえ', 'ひのと', 'つちのえ', 'つちのと', 'かのえ', 'かのと', 'みずのえ', 'みずのと'];
44
+ export const WK_BRANCHES = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
45
+ export const WK_BRANCH_KANA = ['ね', 'うし', 'とら', 'う', 'たつ', 'み', 'うま', 'ひつじ', 'さる', 'とり', 'いぬ', 'い'];
46
+ export const WK_ANIMAL_JA = ['ねずみ', 'うし', 'とら', 'うさぎ', 'たつ', 'へび', 'うま', 'ひつじ', 'さる', 'とり', 'いぬ', 'いのしし'];
47
+ export const WK_ANIMAL_EN = ['Rat', 'Ox', 'Tiger', 'Rabbit', 'Dragon', 'Snake', 'Horse', 'Goat', 'Monkey', 'Rooster', 'Dog', 'Boar'];
48
+
49
+ export function wkIsLeap(y) {
50
+ return (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;
51
+ }
52
+
53
+ export function wkDaysInMonth(y, m) {
54
+ return m === 2 ? (wkIsLeap(y) ? 29 : 28) : [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][m - 1];
55
+ }
56
+
57
+ /** グレゴリオ暦の年月日 → 1970-01-01 からの通算日(Date を使わないのでタイムゾーンで1日ずれない) */
58
+ export function wkToDays(y, m, d) {
59
+ const yy = m <= 2 ? y - 1 : y;
60
+ const era = Math.floor(yy / 400);
61
+ const yoe = yy - era * 400;
62
+ const mp = (m + 9) % 12;
63
+ const doy = Math.floor((153 * mp + 2) / 5) + d - 1;
64
+ const doe = yoe * 365 + Math.floor(yoe / 4) - Math.floor(yoe / 100) + doy;
65
+ return era * 146097 + doe - 719468;
66
+ }
67
+
68
+ export function wkFromDays(z) {
69
+ const zz = z + 719468;
70
+ const era = Math.floor(zz / 146097);
71
+ const doe = zz - era * 146097;
72
+ const yoe = Math.floor((doe - Math.floor(doe / 1460) + Math.floor(doe / 36524) - Math.floor(doe / 146096)) / 365);
73
+ const doy = doe - (365 * yoe + Math.floor(yoe / 4) - Math.floor(yoe / 100));
74
+ const mp = Math.floor((5 * doy + 2) / 153);
75
+ const d = doy - Math.floor((153 * mp + 2) / 5) + 1;
76
+ const m = mp < 10 ? mp + 3 : mp - 9;
77
+ return { y: era * 400 + yoe + (m <= 2 ? 1 : 0), m, d };
78
+ }
79
+
80
+ /** 0=日曜 … 6=土曜(1970-01-01 は木曜) */
81
+ export function wkWeekday(z) {
82
+ return (((z + 4) % 7) + 7) % 7;
83
+ }
84
+
85
+ export function wkPad(n, w) {
86
+ let s = String(Math.abs(n));
87
+ while (s.length < w) s = '0' + s;
88
+ return (n < 0 ? '-' : '') + s;
89
+ }
90
+
91
+ export function wkIso(y, m, d) {
92
+ return wkPad(y, 4) + '-' + wkPad(m, 2) + '-' + wkPad(d, 2);
93
+ }
94
+
95
+ export function wkIsoFromDays(z) {
96
+ const c = wkFromDays(z);
97
+ return wkIso(c.y, c.m, c.d);
98
+ }
99
+
100
+ const WK_ERA_START = WK_ERAS.map((e) => wkToDays(e.start[0], e.start[1], e.start[2]));
101
+ const WK_ERA_END = WK_ERAS.map((e) => (e.end ? wkToDays(e.end[0], e.end[1], e.end[2]) : Infinity));
102
+ const WK_SOLAR_Z = wkToDays(WK_SOLAR_FROM[0], WK_SOLAR_FROM[1], WK_SOLAR_FROM[2]);
103
+
104
+ /** 期間 [fromZ, toZ] に重なる元号を古い順に返す(改元をまたげば2件) */
105
+ export function wkErasInRange(fromZ, toZ) {
106
+ const out = [];
107
+ for (let i = 0; i < WK_ERAS.length; i++) {
108
+ if (WK_ERA_START[i] <= toZ && WK_ERA_END[i] >= fromZ) out.push(i);
109
+ }
110
+ return out;
111
+ }
112
+
113
+ /** 和暦の年(元年=1)。明治は1868年を元年とする */
114
+ export function wkEraYear(i, y) {
115
+ return y - WK_ERAS[i].start[0] + 1;
116
+ }
117
+
118
+ /** 漢数字(十・百・千の位取り)。0 は〇 */
119
+ export function wkKanjiNum(n) {
120
+ const D = ['〇', '一', '二', '三', '四', '五', '六', '七', '八', '九'];
121
+ if (n === 0) return '〇';
122
+ let s = '';
123
+ const units = [[1000, '千'], [100, '百'], [10, '十']];
124
+ let r = n;
125
+ for (const [v, u] of units) {
126
+ const q = Math.floor(r / v);
127
+ if (q) s += (q === 1 ? '' : D[q]) + u;
128
+ r %= v;
129
+ }
130
+ if (r) s += D[r];
131
+ return s;
132
+ }
133
+
134
+ /** 西暦年の漢数字(二〇二六のように1桁ずつ) */
135
+ export function wkKanjiDigits(n) {
136
+ return String(n).replace(/[0-9]/g, (c) => '〇一二三四五六七八九'[Number(c)]);
137
+ }
138
+
139
+ /** 漢数字の連なりを整数へ。十百千を含めば位取り、無ければ1桁ずつ(二〇二六) */
140
+ export function wkKanjiToInt(s) {
141
+ const D = { '〇': 0, '零': 0, '一': 1, '二': 2, '三': 3, '四': 4, '五': 5, '六': 6, '七': 7, '八': 8, '九': 9 };
142
+ if (!/[十百千]/.test(s)) {
143
+ let v = 0;
144
+ for (const c of s) v = v * 10 + D[c];
145
+ return v;
146
+ }
147
+ let total = 0;
148
+ let cur = 0;
149
+ for (const c of s) {
150
+ if (c in D) cur = D[c];
151
+ else {
152
+ const u = c === '十' ? 10 : c === '百' ? 100 : 1000;
153
+ total += (cur || 1) * u;
154
+ cur = 0;
155
+ }
156
+ }
157
+ return total + cur;
158
+ }
159
+
160
+ /** 干支(十干十二支)。1984年=甲子を起点にした暦年の干支で、立春・旧正月での切り替えはしない */
161
+ export function wkEto(y) {
162
+ const i = (((y - 1984) % 60) + 60) % 60;
163
+ const s = i % 10;
164
+ const b = i % 12;
165
+ return {
166
+ kanji: WK_STEMS[s] + WK_BRANCHES[b],
167
+ kana: WK_STEM_KANA[s] + WK_BRANCH_KANA[b],
168
+ branch: WK_BRANCHES[b],
169
+ animal_ja: WK_ANIMAL_JA[b],
170
+ animal_en: WK_ANIMAL_EN[b],
171
+ };
172
+ }
173
+
174
+ const WK_ERA_WORDS = [
175
+ [/^(明治|明|m|meiji)$/i, 0],
176
+ [/^(大正|大|t|taisho|taishou|taishō)$/i, 1],
177
+ [/^(昭和|昭|s|showa|shouwa|shōwa)$/i, 2],
178
+ [/^(平成|平|h|heisei)$/i, 3],
179
+ [/^(令和|令|r|reiwa)$/i, 4],
180
+ ];
181
+
182
+ /**
183
+ * 日付の文字列を読む。西暦(2026-10-01 / 2026/10/1 / 20261001 / 2026年10月1日 / 2026年 / 2026-10)と
184
+ * 和暦(令和8年10月1日 / R8.10.1 / 平成元年 / 令和八年十月一日 / ㋿8.10.1 / Reiwa 8)を受け付ける。
185
+ * 返り値の precision は 'year' | 'month' | 'day'。曜日の書き添え((木)・木曜日・(Thu))は取り出して weekday に入れる。
186
+ */
187
+ export function wkParse(input) {
188
+ const raw = String(input === undefined || input === null ? '' : input);
189
+ let s = raw.normalize('NFKC').trim();
190
+ if (!s) throw new WarekiError('EMPTY', {});
191
+ // 曜日の書き添え
192
+ let weekday = null;
193
+ const WDJ = '日月火水木金土';
194
+ const WDE = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
195
+ s = s.replace(/[((]\s*([日月火水木金土]|sun|mon|tue|wed|thu|fri|sat)[a-z]*\.?\s*(?:曜日?)?\s*[))]/i, (_, w) => {
196
+ weekday = WDJ.indexOf(w) >= 0 ? WDJ.indexOf(w) : WDE.indexOf(w.slice(0, 3).toLowerCase());
197
+ return ' ';
198
+ });
199
+ s = s.replace(/([日月火水木金土])曜日?\s*$/, (_, w) => {
200
+ weekday = WDJ.indexOf(w);
201
+ return '';
202
+ });
203
+ s = s.replace(/,?\s*(sun|mon|tue|wed|thu|fri|sat)[a-z]*\.?\s*$/i, (_, w) => {
204
+ weekday = WDE.indexOf(w.slice(0, 3).toLowerCase());
205
+ return '';
206
+ });
207
+ // 添え書き(生まれ・付・現在)と「西暦」
208
+ s = s.replace(/\s*(生まれ|生|付け?|現在|時点|まで|より|から)\s*$/, '');
209
+ s = s.replace(/^\s*(西暦|AD|A\.D\.)\s*/i, '');
210
+ // 元年・漢数字
211
+ s = s.replace(/元(?=\s*年)/g, '1');
212
+ s = s.replace(/[〇零一二三四五六七八九十百千]+/g, (m) => String(wkKanjiToInt(m)));
213
+ s = s.replace(/\s+/g, '');
214
+ if (!s) throw new WarekiError('EMPTY', {});
215
+
216
+ const SEP = '[年./\\-]';
217
+ const tail = `(?:${SEP}(?:(\\d{1,2})(?:(?:月|[./\\-])(?:(\\d{1,2})日?)?)?)?)?`;
218
+ const wm = new RegExp(`^([^\\d]+?)\\.?(\\d{1,4})${tail}$`).exec(s);
219
+ if (wm && !/^\d/.test(s)) {
220
+ let era = -1;
221
+ for (const [re, i] of WK_ERA_WORDS) if (re.test(wm[1])) era = i;
222
+ if (era < 0) throw new WarekiError('UNKNOWN_ERA', { era: wm[1] });
223
+ return finishParse(raw, 'wareki', era, Number(wm[2]), wm[3], wm[4], weekday);
224
+ }
225
+ let gm = /^(\d{4})(\d{2})(\d{2})$/.exec(s);
226
+ if (gm) return finishParse(raw, 'seireki', -1, Number(gm[1]), gm[2], gm[3], weekday);
227
+ gm = new RegExp(`^(\\d{4})${tail}$`).exec(s);
228
+ if (gm) return finishParse(raw, 'seireki', -1, Number(gm[1]), gm[2], gm[3], weekday);
229
+ if (/^\d{1,3}(?:[年./\-]|$)/.test(s)) throw new WarekiError('NEED_ERA', { text: raw.trim() });
230
+ throw new WarekiError('UNREADABLE', { text: raw.trim() });
231
+ }
232
+
233
+ function finishParse(raw, source, era, year, mStr, dStr, weekday) {
234
+ const month = mStr === undefined ? null : Number(mStr);
235
+ const day = dStr === undefined ? null : Number(dStr);
236
+ const precision = day !== null ? 'day' : month !== null ? 'month' : 'year';
237
+ if (source === 'wareki' && year < 1) throw new WarekiError('ERA_YEAR_ZERO', { era: WK_ERAS[era].name });
238
+ const gy = source === 'wareki' ? WK_ERAS[era].start[0] + year - 1 : year;
239
+ if (gy < WK_MIN_YEAR || gy > WK_MAX_YEAR) throw new WarekiError('OUT_OF_RANGE', { year: gy });
240
+ if (month !== null && (month < 1 || month > 12)) throw new WarekiError('NO_SUCH_DATE', { year: gy, month, day });
241
+ if (day !== null && (day < 1 || day > wkDaysInMonth(gy, month))) throw new WarekiError('NO_SUCH_DATE', { year: gy, month, day });
242
+ return { text: raw.trim(), source, era, eraYear: source === 'wareki' ? year : null, year: gy, month, day, precision, weekday };
243
+ }
244
+
245
+ function wkWarekiEntry(i, y, m, d, precision, fromZ, toZ) {
246
+ const e = WK_ERAS[i];
247
+ const n = wkEraYear(i, y);
248
+ const ny = n === 1 ? '元' : String(n);
249
+ const ky = n === 1 ? '元' : wkKanjiNum(n);
250
+ const p2 = (v) => wkPad(v, 2);
251
+ let full = `${e.name}${ny}年`;
252
+ let kanji = `${e.name}${ky}年`;
253
+ let abbr = `${e.abbr}${n}`;
254
+ let abbrPad = `${e.abbr}${p2(n)}`;
255
+ let en = `${e.en} ${n} (${y})`;
256
+ if (precision !== 'year') {
257
+ full += `${m}月`;
258
+ kanji += `${wkKanjiNum(m)}月`;
259
+ abbr += `.${m}`;
260
+ abbrPad += `.${p2(m)}`;
261
+ en = `${WK_MONTH_EN[m - 1]}, ${e.en} ${n} (${y})`;
262
+ }
263
+ if (precision === 'day') {
264
+ full += `${d}日`;
265
+ kanji += `${wkKanjiNum(d)}日`;
266
+ abbr += `.${d}`;
267
+ abbrPad += `.${p2(d)}`;
268
+ en = `${WK_MONTH_EN[m - 1]} ${d}, ${e.en} ${n} (${y})`;
269
+ }
270
+ const out = {
271
+ era: e.name,
272
+ era_en: e.en,
273
+ abbr: e.abbr,
274
+ year: n,
275
+ formats: { full, kanji, abbr, abbr_pad: abbrPad, en },
276
+ from: wkIsoFromDays(Math.max(fromZ, WK_ERA_START[i])),
277
+ to: wkIsoFromDays(Math.min(toZ, WK_ERA_END[i])),
278
+ };
279
+ if (precision === 'day') out.formats.full_wd = `${full}(${WK_WD_JA[wkWeekday(fromZ)]})`;
280
+ return out;
281
+ }
282
+
283
+ function wkSeirekiFormats(y, m, d, precision, z) {
284
+ if (precision === 'year') {
285
+ return { ja: `${y}年`, iso: String(y), slash: String(y), kanji: `${wkKanjiDigits(y)}年`, en: String(y) };
286
+ }
287
+ if (precision === 'month') {
288
+ return {
289
+ ja: `${y}年${m}月`,
290
+ iso: `${y}-${wkPad(m, 2)}`,
291
+ slash: `${y}/${wkPad(m, 2)}`,
292
+ kanji: `${wkKanjiDigits(y)}年${wkKanjiNum(m)}月`,
293
+ en: `${WK_MONTH_EN[m - 1]} ${y}`,
294
+ };
295
+ }
296
+ const wd = wkWeekday(z);
297
+ return {
298
+ ja: `${y}年${m}月${d}日`,
299
+ ja_wd: `${y}年${m}月${d}日(${WK_WD_JA[wd]})`,
300
+ iso: wkIso(y, m, d),
301
+ slash: `${y}/${wkPad(m, 2)}/${wkPad(d, 2)}`,
302
+ kanji: `${wkKanjiDigits(y)}年${wkKanjiNum(m)}月${wkKanjiNum(d)}日`,
303
+ en: `${WK_WD_EN[wd]}, ${WK_MONTH_EN[m - 1]} ${d}, ${y}`,
304
+ };
305
+ }
306
+
307
+ /** 読んだ日付(wkParse の返り値)を和暦・西暦の両方へ展開する */
308
+ export function wkConvert(p) {
309
+ const warnings = [];
310
+ let precision = p.precision;
311
+ const { year: y } = p;
312
+ let m = p.month;
313
+ let d = p.day;
314
+ // 改暦前(1872年以前)の月日は旧暦なので、年単位に落として換算する
315
+ const beforeSolar = y < WK_SOLAR_FROM[0];
316
+ if (beforeSolar && precision !== 'year') {
317
+ warnings.push({ code: 'LUNAR_CALENDAR', source: p.source });
318
+ precision = 'year';
319
+ m = null;
320
+ d = null;
321
+ }
322
+ let fromZ;
323
+ let toZ;
324
+ if (precision === 'year') {
325
+ fromZ = wkToDays(y, 1, 1);
326
+ toZ = wkToDays(y, 12, 31);
327
+ } else if (precision === 'month') {
328
+ fromZ = wkToDays(y, m, 1);
329
+ toZ = wkToDays(y, m, wkDaysInMonth(y, m));
330
+ } else {
331
+ fromZ = wkToDays(y, m, d);
332
+ toZ = fromZ;
333
+ }
334
+ const idx = wkErasInRange(fromZ, toZ);
335
+ const wareki = idx.map((i) => wkWarekiEntry(i, y, m, d, precision, fromZ, toZ));
336
+ if (p.source === 'wareki') {
337
+ const e = WK_ERAS[p.era];
338
+ const given = `${e.name}${p.eraYear === 1 ? '元' : p.eraYear}年` + (p.precision !== 'year' ? `${p.month}月` : '') + (p.precision === 'day' ? `${p.day}日` : '');
339
+ if (idx.indexOf(p.era) < 0) {
340
+ warnings.push({
341
+ code: fromZ < WK_ERA_START[p.era] ? 'ERA_NOT_STARTED' : 'ERA_ENDED',
342
+ given,
343
+ era: e.name,
344
+ era_en: e.en,
345
+ start: wkIso(e.start[0], e.start[1], e.start[2]),
346
+ end: e.end ? wkIso(e.end[0], e.end[1], e.end[2]) : null,
347
+ correct: wareki.map((w) => w.formats.full),
348
+ correct_en: wareki.map((w) => w.formats.en),
349
+ });
350
+ }
351
+ }
352
+ if (precision === 'day' && p.weekday !== null && p.weekday !== undefined && p.weekday !== wkWeekday(fromZ)) {
353
+ warnings.push({ code: 'WEEKDAY_MISMATCH', given: p.weekday, actual: wkWeekday(fromZ) });
354
+ }
355
+ if (wareki.length > 1) warnings.push({ code: 'ERA_BOUNDARY', eras: wareki.map((w) => w.era) });
356
+ const out = {
357
+ input: p.text,
358
+ source: p.source,
359
+ precision,
360
+ seireki: { year: y, month: m, day: d, formats: wkSeirekiFormats(y, m, d, precision, fromZ) },
361
+ wareki,
362
+ eto: wkEto(y),
363
+ warnings,
364
+ };
365
+ if (precision === 'day') {
366
+ out.seireki.iso = wkIso(y, m, d);
367
+ out.weekday = wkWeekday(fromZ);
368
+ }
369
+ return out;
370
+ }
371
+
372
+ /** 誕生日の「その年の該当日」。2月29日生まれは平年だと該当日が無いので3月1日(年齢計算ニ関スル法律・民法143条) */
373
+ function wkAnniversary(by, bm, bd, n) {
374
+ const y = by + n;
375
+ if (bd > wkDaysInMonth(y, bm)) return wkToDays(y, bm, wkDaysInMonth(y, bm)) + 1;
376
+ return wkToDays(y, bm, bd);
377
+ }
378
+
379
+ /** 月を足した該当日。該当日が無ければ翌月1日(月末日の満了の翌日) */
380
+ function wkAddMonthsLegal(y, m, d, n) {
381
+ const t = (m - 1) + n;
382
+ const yy = y + Math.floor(t / 12);
383
+ const mm = ((t % 12) + 12) % 12 + 1;
384
+ if (d > wkDaysInMonth(yy, mm)) return wkToDays(yy, mm, wkDaysInMonth(yy, mm)) + 1;
385
+ return wkToDays(yy, mm, d);
386
+ }
387
+
388
+ /** 満年齢と数え年・次の誕生日・学歴の年(6-3-3-4制を浪人・留年なしで進んだ場合) */
389
+ export function wkAge(birth, ref) {
390
+ if (birth.precision !== 'day') throw new WarekiError('NEED_FULL_DATE', { field: 'birth' });
391
+ if (ref.precision !== 'day') throw new WarekiError('NEED_FULL_DATE', { field: 'reference' });
392
+ if (birth.year < WK_SOLAR_FROM[0]) throw new WarekiError('LUNAR_BIRTH', {});
393
+ const bz = wkToDays(birth.year, birth.month, birth.day);
394
+ const rz = wkToDays(ref.year, ref.month, ref.day);
395
+ if (rz < bz) throw new WarekiError('REF_BEFORE_BIRTH', { birth: wkIsoFromDays(bz), reference: wkIsoFromDays(rz) });
396
+ const { year: by, month: bm, day: bd } = birth;
397
+ let age = ref.year - by;
398
+ if (wkAnniversary(by, bm, bd, age) > rz) age -= 1;
399
+ const lastZ = wkAnniversary(by, bm, bd, age);
400
+ const lc = wkFromDays(lastZ);
401
+ let months = 0;
402
+ while (months < 12 && wkAddMonthsLegal(lc.y, lc.m, lc.d, months + 1) <= rz) months += 1;
403
+ const days = rz - wkAddMonthsLegal(lc.y, lc.m, lc.d, months);
404
+ const nextZ = wkAnniversary(by, bm, bd, age + 1);
405
+ const isBirthday = lastZ === rz;
406
+ // 4月2日〜翌年4月1日生まれが同じ学年(満6歳に達した日の翌日以後の最初の4月に小学校へ入る)
407
+ const cohort = bm > 4 || (bm === 4 && bd >= 2) ? by : by - 1;
408
+ const school = [
409
+ ['elementary_in', cohort + 7, 4],
410
+ ['elementary_out', cohort + 13, 3],
411
+ ['junior_in', cohort + 13, 4],
412
+ ['junior_out', cohort + 16, 3],
413
+ ['high_in', cohort + 16, 4],
414
+ ['high_out', cohort + 19, 3],
415
+ ['univ_in', cohort + 19, 4],
416
+ ['univ_out', cohort + 23, 3],
417
+ ].map(([key, y, m]) => {
418
+ const fz = wkToDays(y, m, 1);
419
+ const i = wkErasInRange(fz, fz)[0];
420
+ const n = wkEraYear(i, y);
421
+ return { key, year: y, month: m, seireki: `${y}年${m}月`, wareki: `${WK_ERAS[i].name}${n === 1 ? '元' : n}年${m}月` };
422
+ });
423
+ return {
424
+ birth: wkConvert(birth),
425
+ reference: wkIso(ref.year, ref.month, ref.day),
426
+ age,
427
+ months,
428
+ days,
429
+ kazoe: ref.year - by + 1,
430
+ days_lived: rz - bz,
431
+ is_birthday: isBirthday,
432
+ next_birthday: { date: wkIsoFromDays(nextZ), age: age + 1, days_until: nextZ - rz, weekday: wkWeekday(nextZ) },
433
+ school_cohort: cohort,
434
+ // 6-3-3制は1947年(昭和22年)の学制改革から。それより前に小学校へ入った世代には当てはまらない
435
+ school: cohort + 7 >= 1947 ? school : null,
436
+ };
437
+ }
438
+
439
+ /** 元号の一覧(ref は期間の年数を数える基準日の通算日) */
440
+ export function wkEraList(refZ) {
441
+ return WK_ERAS.map((e, i) => {
442
+ const endZ = Math.min(WK_ERA_END[i], refZ);
443
+ const lastY = wkFromDays(Math.max(endZ, WK_ERA_START[i])).y;
444
+ return {
445
+ era: e.name,
446
+ kana: e.kana,
447
+ era_en: e.en,
448
+ abbr: e.abbr,
449
+ start: wkIso(e.start[0], e.start[1], e.start[2]),
450
+ end: e.end ? wkIso(e.end[0], e.end[1], e.end[2]) : null,
451
+ first_year: e.start[0],
452
+ last_year: e.end ? e.end[0] : null,
453
+ years: e.end ? wkEraYear(i, e.end[0]) : wkEraYear(i, lastY),
454
+ offset: e.start[0] - 1,
455
+ current: !e.end,
456
+ };
457
+ });
458
+ }
459
+
460
+ /** 和暦・西暦の早見表(その年生まれの人の ref 年での満年齢つき)。新しい年が先 */
461
+ export function wkYearTable(fromY, toY, refYear) {
462
+ const rows = [];
463
+ for (let y = toY; y >= fromY; y--) {
464
+ const idx = wkErasInRange(wkToDays(y, 1, 1), wkToDays(y, 12, 31));
465
+ const eras = idx.map((i) => {
466
+ const n = wkEraYear(i, y);
467
+ return { era: WK_ERAS[i].name, era_en: WK_ERAS[i].en, abbr: WK_ERAS[i].abbr, year: n, text: `${WK_ERAS[i].name}${n === 1 ? '元' : n}年` };
468
+ });
469
+ const eto = wkEto(y);
470
+ const after = refYear - y;
471
+ rows.push({ year: y, wareki: eras, eto: eto.kanji, animal_ja: eto.animal_ja, animal_en: eto.animal_en, age: after >= 0 ? after : null, age_before_birthday: after - 1 >= 0 ? after - 1 : null });
472
+ }
473
+ return rows;
474
+ }
475
+
476
+ /* ==================== ここまで変換コア ==================== */
477
+
478
+ /* ---- ここから下はMCP側だけの層(入出力・文言)。site側の app.js には UI 用の同じ文言表がある ---- */
479
+
480
+ export class WarekiToolError extends Error {}
481
+
482
+ const WD_SHORT_EN = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
483
+ const wdLabel = (lang, i) => (lang === 'en' ? WK_WD_EN[i] : WK_WD_JA[i]);
484
+
485
+ const ERR_JA = {
486
+ EMPTY: () => '日付が空です。',
487
+ UNREADABLE: (i) => `「${i.text}」を日付として読めません。2026-10-01・2026年10月1日・令和8年10月1日・R8.10.1 のように書いてください。`,
488
+ NEED_ERA: (i) => `「${i.text}」は元号が無いため、西暦か和暦かを決められません。和暦なら「令和8年」「R8」のように元号を付け、西暦は4桁で書いてください。`,
489
+ UNKNOWN_ERA: (i) => `「${i.era}」は対応していない元号です(明治・大正・昭和・平成・令和/M・T・S・H・R)。`,
490
+ ERA_YEAR_ZERO: (i) => `${i.era}0年はありません(最初の年は元年=1年)。`,
491
+ OUT_OF_RANGE: (i) => `${i.year}年は範囲外です(1868年=明治元年から9999年まで)。`,
492
+ NO_SUCH_DATE: (i) => (i.day === null || i.day === undefined ? `${i.month}月という月はありません。` : `${i.year}年${i.month}月${i.day}日は存在しない日付です。`),
493
+ NEED_FULL_DATE: (i) => `年齢の計算には${i.field === 'birth' ? '生年月日' : '基準日'}を年月日まで入れてください。`,
494
+ LUNAR_BIRTH: () => '1872年(明治5年)以前の生年月日は旧暦のため、満年齢を計算できません。',
495
+ REF_BEFORE_BIRTH: (i) => `基準日(${i.reference})が生年月日(${i.birth})より前です。`,
496
+ };
497
+
498
+ const ERR_EN = {
499
+ EMPTY: () => 'The date is empty.',
500
+ UNREADABLE: (i) => `"${i.text}" could not be read as a date. Write it like 2026-10-01, 令和8年10月1日 or R8.10.1.`,
501
+ NEED_ERA: (i) => `"${i.text}" has no era name, so it is unclear whether it is a Western or a Japanese year. Add the era (Reiwa 8, R8) or write the Western year with four digits.`,
502
+ UNKNOWN_ERA: (i) => `"${i.era}" is not a supported era (Meiji, Taisho, Showa, Heisei, Reiwa / M, T, S, H, R).`,
503
+ ERA_YEAR_ZERO: (i) => `There is no year 0 of ${i.era} (the first year is gannen = year 1).`,
504
+ OUT_OF_RANGE: (i) => `The year ${i.year} is out of range (1868 = Meiji 1 to 9999).`,
505
+ NO_SUCH_DATE: (i) => (i.day === null || i.day === undefined ? `There is no month ${i.month}.` : `${i.year}-${i.month}-${i.day} does not exist.`),
506
+ NEED_FULL_DATE: (i) => `The age calculation needs a full ${i.field === 'birth' ? 'date of birth' : 'reference date'} (year, month and day).`,
507
+ LUNAR_BIRTH: () => 'Birth dates in 1872 (Meiji 5) or earlier use the old lunisolar calendar, so the age cannot be worked out.',
508
+ REF_BEFORE_BIRTH: (i) => `The reference date (${i.reference}) is before the date of birth (${i.birth}).`,
509
+ };
510
+
511
+ const ERA_EN = Object.fromEntries(WK_ERAS.map((e) => [e.name, e.en]));
512
+
513
+ const WARN_JA = {
514
+ LUNAR_CALENDAR: () => '明治5年(1872年)以前は旧暦(天保暦)で、月日が西暦と一致しません。年だけで換算しました(旧暦の年末は西暦では翌年の1〜2月にあたります)。',
515
+ ERA_NOT_STARTED: (w) => `${w.given}は${w.era}の始まり(${w.start})より前の日付です。この日の正しい和暦は ${w.correct.join('/')} です。`,
516
+ ERA_ENDED: (w) => `${w.given}は${w.era}の終わり(${w.end})より後の日付です。正しい和暦は ${w.correct.join('/')} です。`,
517
+ WEEKDAY_MISMATCH: (w) => `書き添えの曜日(${WK_WD_JA[w.given]})が実際の曜日(${WK_WD_JA[w.actual]})と違います。`,
518
+ ERA_BOUNDARY: (w) => `この期間の途中で改元しています(${w.eras.join('→')})。日付まで入れると1つに決まります。`,
519
+ };
520
+
521
+ const WARN_EN = {
522
+ LUNAR_CALENDAR: () => 'Before 1873 (Meiji 5 and earlier) Japan used the lunisolar calendar, so months and days do not match the Western calendar. Converted by year only (the end of a lunar year falls in January or February of the next Western year).',
523
+ ERA_NOT_STARTED: (w) => `${w.given} is before ${w.era_en} began (${w.start}). The correct Japanese date is ${w.correct_en.join(' / ')} (${w.correct.join(' / ')}).`,
524
+ ERA_ENDED: (w) => `${w.given} is after ${w.era_en} ended (${w.end}). The correct Japanese date is ${w.correct_en.join(' / ')} (${w.correct.join(' / ')}).`,
525
+ WEEKDAY_MISMATCH: (w) => `The weekday written with the date (${WD_SHORT_EN[w.given]}) does not match the actual weekday (${WD_SHORT_EN[w.actual]}).`,
526
+ ERA_BOUNDARY: (w) => `The era changed during this period (${w.eras.map((e) => ERA_EN[e] || e).join(' → ')}). Give the full date to get a single answer.`,
527
+ };
528
+
529
+ const SCHOOL_JA = {
530
+ elementary_in: '小学校入学', elementary_out: '小学校卒業', junior_in: '中学校入学', junior_out: '中学校卒業',
531
+ high_in: '高等学校入学', high_out: '高等学校卒業', univ_in: '大学入学', univ_out: '大学卒業(4年制)',
532
+ };
533
+ const SCHOOL_EN = {
534
+ elementary_in: 'Elementary school entry', elementary_out: 'Elementary school graduation', junior_in: 'Junior high entry', junior_out: 'Junior high graduation',
535
+ high_in: 'High school entry', high_out: 'High school graduation', univ_in: 'University entry', univ_out: 'University graduation (4 years)',
536
+ };
537
+
538
+ const errText = (lang, code, info) => {
539
+ const table = lang === 'en' ? ERR_EN : ERR_JA;
540
+ return table[code] ? table[code](info || {}) : code;
541
+ };
542
+ const warnText = (lang, w) => {
543
+ const table = lang === 'en' ? WARN_EN : WARN_JA;
544
+ return { code: w.code, message: table[w.code] ? table[w.code](w) : w.code };
545
+ };
546
+
547
+ /** 日本時間の今日(MCPサーバーのタイムゾーンに左右されない) */
548
+ function todayJst() {
549
+ // 書式の文字列に頼らず部品で組み立てる(en-CA の ISO 風表記は ICU の版によって 10/1/2026 になる)
550
+ const parts = new Intl.DateTimeFormat('en-US', { timeZone: 'Asia/Tokyo', year: 'numeric', month: 'numeric', day: 'numeric' }).formatToParts(new Date());
551
+ const get = (type) => Number(parts.find((x) => x.type === type).value);
552
+ return wkIso(get('year'), get('month'), get('day'));
553
+ }
554
+
555
+ /** wkConvert の結果に曜日・干支の表示名と指摘の文言を足す */
556
+ function shapeConvert(r, lang) {
557
+ const out = {
558
+ ok: true,
559
+ input: r.input,
560
+ detected: r.source,
561
+ precision: r.precision,
562
+ seireki: r.seireki,
563
+ wareki: r.wareki,
564
+ eto: { kanji: r.eto.kanji, kana: r.eto.kana, animal: lang === 'en' ? r.eto.animal_en : r.eto.animal_ja },
565
+ };
566
+ if (r.weekday !== undefined) {
567
+ out.weekday = wdLabel(lang, r.weekday);
568
+ out.weekday_index = r.weekday;
569
+ }
570
+ if (r.warnings.length) out.notes = r.warnings.map((w) => warnText(lang, w));
571
+ return out;
572
+ }
573
+
574
+ function convertOne(text, lang) {
575
+ try {
576
+ return shapeConvert(wkConvert(wkParse(text)), lang);
577
+ } catch (err) {
578
+ if (!(err instanceof WarekiError)) throw err;
579
+ // 日付の書き方の誤りは「呼び出し方の誤り」ではないので、例外ではなく結果として返す
580
+ return { ok: false, input: String(text), error: { code: err.code, message: errText(lang, err.code, err.info) } };
581
+ }
582
+ }
583
+
584
+ const hasText = (v) => typeof v === 'string' && v.trim() !== '';
585
+ const MAX_DATES = 1000;
586
+ const MAX_TABLE_ROWS = 500;
587
+
588
+ /**
589
+ * MCPツール wareki_convert の本体。和暦⇄西暦の変換(1件/一括)・満年齢・元号一覧と早見表の3つを受ける。
590
+ * 計算そのものは変換コア(site版と同一)に任せ、ここは入出力と文言だけを持つ。
591
+ */
592
+ export async function warekiConvertTool(opts = {}) {
593
+ const o = opts || {};
594
+ const lang = o.lang === undefined ? 'ja' : o.lang;
595
+ if (lang !== 'ja' && lang !== 'en') throw new WarekiToolError(`lang は ja か en: ${o.lang}`);
596
+ let mode = o.mode;
597
+ if (mode === undefined) mode = hasText(o.birth) ? 'age' : hasText(o.date) || Array.isArray(o.dates) ? 'convert' : 'eras';
598
+ if (mode !== 'convert' && mode !== 'age' && mode !== 'eras') {
599
+ throw new WarekiToolError(`mode は convert / age / eras のどれかです: ${o.mode}`);
600
+ }
601
+
602
+ if (mode === 'convert') {
603
+ if (Array.isArray(o.dates)) {
604
+ if (o.dates.length === 0) throw new WarekiToolError('dates が空です');
605
+ if (o.dates.length > MAX_DATES) throw new WarekiToolError(`dates は ${MAX_DATES} 件までです(${o.dates.length} 件)`);
606
+ const results = o.dates.map((d) => convertOne(d, lang));
607
+ return { ok: results.every((r) => r.ok), mode, count: results.length, errors: results.filter((r) => !r.ok).length, results };
608
+ }
609
+ if (!hasText(o.date)) throw new WarekiToolError('mode=convert には date(または dates)が要ります');
610
+ return Object.assign({ mode }, convertOne(o.date, lang));
611
+ }
612
+
613
+ if (mode === 'age') {
614
+ if (!hasText(o.birth)) throw new WarekiToolError('mode=age には birth(生年月日)が要ります');
615
+ const refText = hasText(o.reference) ? o.reference : todayJst();
616
+ let r;
617
+ try {
618
+ r = wkAge(wkParse(o.birth), wkParse(refText));
619
+ } catch (err) {
620
+ if (!(err instanceof WarekiError)) throw err;
621
+ return { ok: false, mode, error: { code: err.code, message: errText(lang, err.code, err.info) } };
622
+ }
623
+ const school = lang === 'en' ? SCHOOL_EN : SCHOOL_JA;
624
+ return {
625
+ ok: true,
626
+ mode,
627
+ birth: shapeConvert(r.birth, lang),
628
+ reference: r.reference,
629
+ reference_is_today: !hasText(o.reference),
630
+ age: r.age,
631
+ age_detail: { years: r.age, months: r.months, days: r.days },
632
+ kazoe: r.kazoe,
633
+ days_lived: r.days_lived,
634
+ is_birthday: r.is_birthday,
635
+ next_birthday: Object.assign({}, r.next_birthday, { weekday: wdLabel(lang, r.next_birthday.weekday) }),
636
+ school: r.school ? r.school.map((s) => ({ event: school[s.key], key: s.key, seireki: s.seireki, wareki: s.wareki })) : null,
637
+ };
638
+ }
639
+
640
+ // eras
641
+ const refText = hasText(o.reference) ? o.reference : todayJst();
642
+ let ref;
643
+ try {
644
+ ref = wkParse(refText);
645
+ } catch (err) {
646
+ if (!(err instanceof WarekiError)) throw err;
647
+ return { ok: false, mode, error: { code: err.code, message: errText(lang, err.code, err.info) } };
648
+ }
649
+ const refZ = wkToDays(ref.year, ref.month || 12, ref.day || (ref.month ? wkDaysInMonth(ref.year, ref.month) : 31));
650
+ const out = { ok: true, mode, reference: wkIsoFromDays(refZ), eras: wkEraList(refZ) };
651
+ if (o.from_year !== undefined || o.to_year !== undefined) {
652
+ const from = o.from_year === undefined ? WK_MIN_YEAR : o.from_year;
653
+ const to = o.to_year === undefined ? ref.year : o.to_year;
654
+ if (!Number.isInteger(from) || !Number.isInteger(to) || from < WK_MIN_YEAR || to > WK_MAX_YEAR || from > to) {
655
+ throw new WarekiToolError(`from_year / to_year は ${WK_MIN_YEAR}〜${WK_MAX_YEAR} の整数で from_year <= to_year: ${from}, ${to}`);
656
+ }
657
+ if (to - from + 1 > MAX_TABLE_ROWS) throw new WarekiToolError(`早見表は ${MAX_TABLE_ROWS} 年分までです(${to - from + 1} 年分)`);
658
+ out.age_reference_year = ref.year;
659
+ out.year_table = wkYearTable(from, to, ref.year).map((row) => ({
660
+ year: row.year,
661
+ wareki: row.wareki.map((w) => (lang === 'en' ? `${w.era_en} ${w.year}` : w.text)).join(' / '),
662
+ eto: row.eto,
663
+ animal: lang === 'en' ? row.animal_en : row.animal_ja,
664
+ age: row.age,
665
+ age_before_birthday: row.age_before_birthday,
666
+ }));
667
+ }
668
+ return out;
669
+ }