@first-ch/tools-mcp 0.28.0 → 0.30.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.28.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 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理))をMCPツールとして提供するサーバー",
3
+ "version": "0.30.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営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵))をMCPツールとして提供するサーバー",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"
@@ -155,7 +155,26 @@
155
155
  "half-width",
156
156
  "japanese",
157
157
  "normalize",
158
- "text-cleaner"
158
+ "text-cleaner",
159
+ "cidr",
160
+ "subnet",
161
+ "subnet-calculator",
162
+ "ip",
163
+ "ipv4",
164
+ "ipv6",
165
+ "netmask",
166
+ "network",
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"
159
178
  ],
160
179
  "author": "First CH LLC (https://first-ch.com)",
161
180
  "homepage": "https://tools.first-ch.com",
@@ -200,6 +219,9 @@
200
219
  "case-convert.mjs",
201
220
  "csv-json.mjs",
202
221
  "zenkaku.mjs",
222
+ "cidr.mjs",
223
+ "date-calc.mjs",
224
+ "date-holidays.json",
203
225
  "vendor/",
204
226
  "README.md",
205
227
  "LICENSE"
package/server.mjs CHANGED
@@ -31,6 +31,8 @@ import { robotsTxtGenerate } from './robots-txt.mjs';
31
31
  import { caseConvertTool } from './case-convert.mjs';
32
32
  import { zenkakuConvertTool } from './zenkaku.mjs';
33
33
  import { csvConvertTool } from './csv-json.mjs';
34
+ import { cidrCalcTool } from './cidr.mjs';
35
+ import { dateCalcTool } from './date-calc.mjs';
34
36
 
35
37
  const { version } = createRequire(import.meta.url)('./package.json');
36
38
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -1344,4 +1346,87 @@ server.registerTool(
1344
1346
  },
1345
1347
  );
1346
1348
 
1349
+ server.registerTool(
1350
+ 'cidr_calc',
1351
+ {
1352
+ title: 'IPアドレス・CIDRの計算',
1353
+ description:
1354
+ 'CIDR表記・サブネットマスク・ワイルドカードマスク・単体のIPから、ネットワークアドレス・ブロードキャスト・' +
1355
+ '使えるホストの範囲・アドレス数・逆引きゾーン・2進表記までを計算する(tools.first-ch.com/cidr/ と同一ロジック)。' +
1356
+ 'サーバー設定・ファイアウォール・許可リストの作成時のサブネット計算に使う。**IPv4とIPv6の両対応**' +
1357
+ '(IPv6は `::` の省略・末尾のIPv4表記・`[...]`・`%zone` を読み、出力は RFC 5952 に従う)。' +
1358
+ '`192.168.1.5 255.255.255.0`(マスク併記)や `192.168.1.5/0.0.0.255`(ACLのワイルドカード)も同じ入力欄で受け取る。' +
1359
+ '**ホスト数の例外も織り込む**: `/31` は点対点リンクとして2アドレスとも使え(RFC 3021)、`/32` は1台、IPv6にブロードキャストは無い。' +
1360
+ '入力がネットワークアドレスでない(ホスト部にビットが立っている)ときは、設定に書くべき本来のCIDRを notes で返す。' +
1361
+ '**先頭に0の付いたオクテット(192.168.001.1)は受け取らない**(8進数として読む実装があり、同じ表記が別のアドレスになるため)。' +
1362
+ 'アドレス帯は IANA の Special-Purpose Address Registry の主要ブロック(プライベート・CGNAT・ループバック・リンクローカル・' +
1363
+ '文書用・マルチキャスト・ULA ほか)と照合して種別を返し、ネットワークがその帯からはみ出す場合も指摘する。' +
1364
+ '`split` を渡すとそのプレフィックス長で均等に分割した一覧を、`contains` を渡すと各アドレスがそのネットワークに入るかを返す。' +
1365
+ '`range` に「10.0.0.5 - 10.0.0.200」のような範囲・CIDR・単体IPを(`;` か改行で区切って)渡すと、' +
1366
+ '**重なりと隣接をまとめたうえで過不足なく覆う最小個数のCIDR集合**へ逆算する。' +
1367
+ '計算はすべてBigIntで行い、完全ローカル処理・ネットワーク送信なし。',
1368
+ inputSchema: {
1369
+ cidr: z.string().optional().describe('計算するブロック(例: 192.168.1.0/24 / 10.0.0.1 255.0.0.0 / 2001:db8::1/48。range と併用可)'),
1370
+ split: z.number().int().optional().describe('分割後のプレフィックス長(cidr と一緒に渡す。元より長い値)'),
1371
+ contains: z.array(z.string()).optional().describe('そのネットワークに含まれるかを確かめるIPアドレスの配列(cidr と一緒に渡す)'),
1372
+ range: z
1373
+ .string()
1374
+ .optional()
1375
+ .describe('最小のCIDR集合へ逆算する範囲。1行1件(`;` 区切りも可)で「a - b」「a ~ b」「a..b」やCIDR・単体IPを混ぜられる'),
1376
+ limit: z.number().int().min(1).max(4096).optional().describe('split で返すサブネットの最大件数(既定 256)'),
1377
+ lang: z.enum(['ja', 'en']).optional().describe("指摘事項とエラーの言語(既定 'ja')"),
1378
+ },
1379
+ },
1380
+ async (opts) => {
1381
+ await logUsage('cidr_calc');
1382
+ return asText(await cidrCalcTool(opts));
1383
+ },
1384
+ );
1385
+
1386
+ server.registerTool(
1387
+ 'date_calc',
1388
+ {
1389
+ title: '日数・営業日の計算',
1390
+ description:
1391
+ '2つの日付の間の日数・営業日数、起点日から N日後/N営業日後の期日、締め日と支払サイトからの支払日を計算する' +
1392
+ '(tools.first-ch.com/date-calc/ と同一ロジック)。納期・検収期限・支払サイトの確認に使う。' +
1393
+ '**営業日は「土日・日本の祝日・指定した休業日を除いた日」**で、祝日は内閣府「国民の祝日について」の一覧を同梱しており' +
1394
+ '(1970年〜2027年)、ハッピーマンデーで動く祝日・日曜と重なったときの振替休日・前後を祝日に挟まれた国民の休日' +
1395
+ '(2026-09-22 など)・年で変わる春分の日/秋分の日がすべて入る。' +
1396
+ '`mode="between"` は start と end の間の暦日数・営業日数・休みの内訳・期間内の祝日一覧を返す。' +
1397
+ '`mode="add"` は base から n(負なら過去へ)を unit の単位で進めた期日を返し、飛ばした休みも一覧で返す。' +
1398
+ '**「受領後10営業日」は初日を数えるかで1日ずれる**ため、民法の原則どおり翌日起算を既定とし、' +
1399
+ '`include_start=true` で起点日を1日目として数える。' +
1400
+ '`mode="payment"` は invoice・closing(締め日)・pay_months・pay_day から支払日を求め、' +
1401
+ '休みに当たったら `pay_adjust`(既定 prev=前営業日へ繰り上げ・日本の商慣習)で寄せる。' +
1402
+ '週の休み(weekend)・年末年始(year_end)・自社の休業日(closed_dates)・休日出勤(work_dates)を指定できる。' +
1403
+ '日付は「1970-01-01からの通算日」の整数で扱うのでサーバーのタイムゾーンで1日ずれない。完全ローカル処理・ネットワーク送信なし。',
1404
+ inputSchema: {
1405
+ mode: z.enum(['between', 'add', 'payment']).optional().describe('計算の種類(省略時は渡した引数から判定)'),
1406
+ start: z.string().optional().describe('mode=between の開始日(2026-09-01 / 2026/9/1 / 20260901)'),
1407
+ end: z.string().optional().describe('mode=between の終了日'),
1408
+ base: z.string().optional().describe('mode=add の起点日'),
1409
+ n: z.number().int().optional().describe('mode=add で加える量(負の値なら過去へ数える)'),
1410
+ unit: z.enum(['days', 'business', 'weeks', 'months', 'years']).optional().describe("加える単位(既定 'business')"),
1411
+ include_start: z.boolean().optional().describe('起点日(開始日)を1日目として数えるか。between の既定は true・add の既定は false'),
1412
+ adjust: z.enum(['none', 'next', 'prev']).optional().describe("期日が休みのときの寄せ方(既定 'none'・unit=business では常に営業日になるため無効)"),
1413
+ invoice: z.string().optional().describe('mode=payment の請求・発生日'),
1414
+ closing: z.union([z.number().int(), z.string()]).optional().describe("締め日。'eom'(月末・既定)/ 1〜31 / 'none'(締めなし=発生日から)"),
1415
+ pay_months: z.number().int().optional().describe('支払月(0=当月 / 1=翌月・既定 / 2=翌々月 …12まで)'),
1416
+ pay_day: z.union([z.number().int(), z.string()]).optional().describe("支払日。'eom'(月末・既定)か 1〜31"),
1417
+ pay_adjust: z.enum(['none', 'next', 'prev']).optional().describe("支払日が休みのときの寄せ方(既定 'prev')"),
1418
+ weekend: z.enum(['sat-sun', 'sun', 'fri-sat', 'none']).optional().describe("週の休み(既定 'sat-sun')"),
1419
+ holidays: z.boolean().optional().describe('日本の祝日を休みとして数えるか(既定 true)'),
1420
+ year_end: z.boolean().optional().describe('年末年始(12/29〜1/3)も休みにするか(既定 false)'),
1421
+ closed_dates: z.array(z.string()).optional().describe('追加の休業日(夏季休業・創立記念日など)'),
1422
+ work_dates: z.array(z.string()).optional().describe('追加の営業日(休日出勤)。土日祝でも必ず営業日として数える'),
1423
+ lang: z.enum(['ja', 'en']).optional().describe("曜日・祝日名・指摘事項の言語(既定 'ja')"),
1424
+ },
1425
+ },
1426
+ async (opts) => {
1427
+ await logUsage('date_calc');
1428
+ return asText(await dateCalcTool(opts));
1429
+ },
1430
+ );
1431
+
1347
1432
  await server.connect(new StdioServerTransport());