@first-ch/tools-mcp 0.29.0 → 0.31.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/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@first-ch/tools-mcp",
3
- "version": "0.29.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集合の逆算))を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ツールとして提供するサーバー",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"
@@ -164,7 +164,22 @@
164
164
  "ipv6",
165
165
  "netmask",
166
166
  "network",
167
- "ip-range"
167
+ "ip-range",
168
+ "date",
169
+ "business-days",
170
+ "workdays",
171
+ "holidays",
172
+ "japan",
173
+ "japanese-holidays",
174
+ "date-calculator",
175
+ "due-date",
176
+ "payment-terms",
177
+ "invoice",
178
+ "html-to-markdown",
179
+ "html2markdown",
180
+ "markdown-converter",
181
+ "web-scraping",
182
+ "content-migration"
168
183
  ],
169
184
  "author": "First CH LLC (https://first-ch.com)",
170
185
  "homepage": "https://tools.first-ch.com",
@@ -210,6 +225,9 @@
210
225
  "csv-json.mjs",
211
226
  "zenkaku.mjs",
212
227
  "cidr.mjs",
228
+ "date-calc.mjs",
229
+ "html-md.mjs",
230
+ "date-holidays.json",
213
231
  "vendor/",
214
232
  "README.md",
215
233
  "LICENSE"
package/server.mjs CHANGED
@@ -32,6 +32,8 @@ import { caseConvertTool } from './case-convert.mjs';
32
32
  import { zenkakuConvertTool } from './zenkaku.mjs';
33
33
  import { csvConvertTool } from './csv-json.mjs';
34
34
  import { cidrCalcTool } from './cidr.mjs';
35
+ import { dateCalcTool } from './date-calc.mjs';
36
+ import { htmlToMarkdownTool } from './html-md.mjs';
35
37
 
36
38
  const { version } = createRequire(import.meta.url)('./package.json');
37
39
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -1382,4 +1384,99 @@ server.registerTool(
1382
1384
  },
1383
1385
  );
1384
1386
 
1387
+ server.registerTool(
1388
+ 'date_calc',
1389
+ {
1390
+ title: '日数・営業日の計算',
1391
+ description:
1392
+ '2つの日付の間の日数・営業日数、起点日から N日後/N営業日後の期日、締め日と支払サイトからの支払日を計算する' +
1393
+ '(tools.first-ch.com/date-calc/ と同一ロジック)。納期・検収期限・支払サイトの確認に使う。' +
1394
+ '**営業日は「土日・日本の祝日・指定した休業日を除いた日」**で、祝日は内閣府「国民の祝日について」の一覧を同梱しており' +
1395
+ '(1970年〜2027年)、ハッピーマンデーで動く祝日・日曜と重なったときの振替休日・前後を祝日に挟まれた国民の休日' +
1396
+ '(2026-09-22 など)・年で変わる春分の日/秋分の日がすべて入る。' +
1397
+ '`mode="between"` は start と end の間の暦日数・営業日数・休みの内訳・期間内の祝日一覧を返す。' +
1398
+ '`mode="add"` は base から n(負なら過去へ)を unit の単位で進めた期日を返し、飛ばした休みも一覧で返す。' +
1399
+ '**「受領後10営業日」は初日を数えるかで1日ずれる**ため、民法の原則どおり翌日起算を既定とし、' +
1400
+ '`include_start=true` で起点日を1日目として数える。' +
1401
+ '`mode="payment"` は invoice・closing(締め日)・pay_months・pay_day から支払日を求め、' +
1402
+ '休みに当たったら `pay_adjust`(既定 prev=前営業日へ繰り上げ・日本の商慣習)で寄せる。' +
1403
+ '週の休み(weekend)・年末年始(year_end)・自社の休業日(closed_dates)・休日出勤(work_dates)を指定できる。' +
1404
+ '日付は「1970-01-01からの通算日」の整数で扱うのでサーバーのタイムゾーンで1日ずれない。完全ローカル処理・ネットワーク送信なし。',
1405
+ inputSchema: {
1406
+ mode: z.enum(['between', 'add', 'payment']).optional().describe('計算の種類(省略時は渡した引数から判定)'),
1407
+ start: z.string().optional().describe('mode=between の開始日(2026-09-01 / 2026/9/1 / 20260901)'),
1408
+ end: z.string().optional().describe('mode=between の終了日'),
1409
+ base: z.string().optional().describe('mode=add の起点日'),
1410
+ n: z.number().int().optional().describe('mode=add で加える量(負の値なら過去へ数える)'),
1411
+ unit: z.enum(['days', 'business', 'weeks', 'months', 'years']).optional().describe("加える単位(既定 'business')"),
1412
+ include_start: z.boolean().optional().describe('起点日(開始日)を1日目として数えるか。between の既定は true・add の既定は false'),
1413
+ adjust: z.enum(['none', 'next', 'prev']).optional().describe("期日が休みのときの寄せ方(既定 'none'・unit=business では常に営業日になるため無効)"),
1414
+ invoice: z.string().optional().describe('mode=payment の請求・発生日'),
1415
+ closing: z.union([z.number().int(), z.string()]).optional().describe("締め日。'eom'(月末・既定)/ 1〜31 / 'none'(締めなし=発生日から)"),
1416
+ pay_months: z.number().int().optional().describe('支払月(0=当月 / 1=翌月・既定 / 2=翌々月 …12まで)'),
1417
+ pay_day: z.union([z.number().int(), z.string()]).optional().describe("支払日。'eom'(月末・既定)か 1〜31"),
1418
+ pay_adjust: z.enum(['none', 'next', 'prev']).optional().describe("支払日が休みのときの寄せ方(既定 'prev')"),
1419
+ weekend: z.enum(['sat-sun', 'sun', 'fri-sat', 'none']).optional().describe("週の休み(既定 'sat-sun')"),
1420
+ holidays: z.boolean().optional().describe('日本の祝日を休みとして数えるか(既定 true)'),
1421
+ year_end: z.boolean().optional().describe('年末年始(12/29〜1/3)も休みにするか(既定 false)'),
1422
+ closed_dates: z.array(z.string()).optional().describe('追加の休業日(夏季休業・創立記念日など)'),
1423
+ work_dates: z.array(z.string()).optional().describe('追加の営業日(休日出勤)。土日祝でも必ず営業日として数える'),
1424
+ lang: z.enum(['ja', 'en']).optional().describe("曜日・祝日名・指摘事項の言語(既定 'ja')"),
1425
+ },
1426
+ },
1427
+ async (opts) => {
1428
+ await logUsage('date_calc');
1429
+ return asText(await dateCalcTool(opts));
1430
+ },
1431
+ );
1432
+
1433
+ server.registerTool(
1434
+ 'html_to_markdown',
1435
+ {
1436
+ title: 'HTML → Markdown 変換',
1437
+ description:
1438
+ 'HTML断片をMarkdownへ変換する(tools.first-ch.com/html-md/ と同一ロジック)。' +
1439
+ '取得したページの本文をMarkdownに直して渡す前処理、既存サイトの原稿をMarkdown管理へ移す移行作業に使う。' +
1440
+ '見出し(h1〜h6)・段落・改行・強調・取り消し線・リスト(入れ子・start 属性・チェックボックス)・' +
1441
+ '表(thead / caption と align / text-align による列の配置)・リンク・画像・コードブロック' +
1442
+ "(class=\"language-*\" から言語を拾う)・引用・水平線・定義リスト・figure / figcaption・details / summary に対応し、" +
1443
+ 'script・style・hidden や display:none の要素・装飾のための div / span は自動で取り除く。' +
1444
+ '**HTMLの解釈にブラウザのDOMを使っていない**——字句解析も木の組み立ても自前なので、Web版と結果が一致し、' +
1445
+ '閉じ忘れたタグは末尾で閉じ、行き場のない閉じタグは捨てて変換を続ける' +
1446
+ '(**属性の引用符が閉じていない場合だけは打ち切る**。続けると残りの文書全体を1つの属性値として飲み込むため)。' +
1447
+ '補った内容・落とした内容はすべて notes で返す。' +
1448
+ '**Markdownに書けないものは黙って捨てない**: セルの結合(colspan は空セルで埋め、rowspan は先頭行にだけ値が入る)・' +
1449
+ 'セル内のリスト/コードブロック(その表だけHTMLのまま残す)・定義リスト(Markdown Extra の ": " 記法)・' +
1450
+ 'sup / sub / mark / iframe / svg(unknown で「HTMLのまま残す/文字だけ残す/取り除く」を選ぶ)。' +
1451
+ '表・タスクリスト・取り消し線はGFMの拡張でCommonMarkには無いため gfm=false で切れる。' +
1452
+ '**相対URLは貼り先で必ず壊れる**ので、base_url を渡すとリンクと画像を絶対URLへ直す(アンカーと絶対URLはそのまま)。' +
1453
+ 'main_only=true は main / article の中だけを取り出して header・nav・footer・aside・form を落とす。' +
1454
+ 'html か path のどちらか一方を渡す。outputPath を渡すとファイルへ書き出す(本文は返さない)。' +
1455
+ 'ネットワークへは出ないので、ページの取得は呼び出し側で行うこと。完全ローカル処理・ネットワーク送信なし。',
1456
+ inputSchema: {
1457
+ html: z.string().optional().describe('変換するHTML(path と排他)'),
1458
+ path: z.string().optional().describe('変換するHTMLファイルの絶対パス(UTF-8として読む。html と排他)'),
1459
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると markdown は返さない)'),
1460
+ main_only: z.boolean().optional().describe('main / article の中だけを取り出し、header・nav・footer・aside・form を落とす(既定 false)'),
1461
+ base_url: z.string().optional().describe('相対URLを絶対URLへ直すための基準(元ページのアドレス)'),
1462
+ gfm: z.boolean().optional().describe('表・タスクリスト・取り消し線(GitHub Flavored Markdown。既定 true)'),
1463
+ escape: z.boolean().optional().describe('本文中の * _ [ ` や行頭の # - 1. をバックスラッシュで打ち消す(既定 true)'),
1464
+ pad_tables: z.boolean().optional().describe('表の桁を揃える(全角を2桁として数える。既定 true)'),
1465
+ headings: z.enum(['atx', 'setext']).optional().describe("見出しの書き方(既定 'atx' = #)"),
1466
+ bullet: z.enum(['-', '*', '+']).optional().describe("箇条書きの印(既定 '-')"),
1467
+ code_block: z.enum(['fenced', 'indented']).optional().describe("コードブロックの書き方(既定 'fenced')"),
1468
+ links: z.enum(['inline', 'reference', 'strip']).optional().describe("リンクの書き方(既定 'inline'。'reference' は末尾にまとめる / 'strip' は文字だけ残す)"),
1469
+ images: z.enum(['keep', 'alt', 'drop']).optional().describe("画像の扱い(既定 'keep' = ![alt](src))"),
1470
+ tables: z.enum(['gfm', 'html']).optional().describe("表の書き方(既定 'gfm')"),
1471
+ unknown: z.enum(['keep', 'text', 'drop']).optional().describe("Markdownに対応が無い要素の扱い(既定 'keep' = HTMLのまま)"),
1472
+ br: z.enum(['spaces', 'backslash', 'html', 'space']).optional().describe("<br> の書き方(既定 'spaces' = 行末に半角スペース2つ)"),
1473
+ lang: z.enum(['ja', 'en']).optional().describe("notes の言語(既定 'ja')"),
1474
+ },
1475
+ },
1476
+ async (opts) => {
1477
+ await logUsage('html_to_markdown');
1478
+ return asText(await htmlToMarkdownTool(opts));
1479
+ },
1480
+ );
1481
+
1385
1482
  await server.connect(new StdioServerTransport());