@first-ch/tools-mcp 0.29.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/README.md +6 -2
- package/date-calc.mjs +734 -0
- package/date-holidays.json +957 -0
- package/package.json +15 -3
- package/server.mjs +47 -0
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@first-ch/tools-mcp",
|
|
3
|
-
"version": "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
|
|
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"
|
|
@@ -164,7 +164,17 @@
|
|
|
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"
|
|
168
178
|
],
|
|
169
179
|
"author": "First CH LLC (https://first-ch.com)",
|
|
170
180
|
"homepage": "https://tools.first-ch.com",
|
|
@@ -210,6 +220,8 @@
|
|
|
210
220
|
"csv-json.mjs",
|
|
211
221
|
"zenkaku.mjs",
|
|
212
222
|
"cidr.mjs",
|
|
223
|
+
"date-calc.mjs",
|
|
224
|
+
"date-holidays.json",
|
|
213
225
|
"vendor/",
|
|
214
226
|
"README.md",
|
|
215
227
|
"LICENSE"
|
package/server.mjs
CHANGED
|
@@ -32,6 +32,7 @@ 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';
|
|
35
36
|
|
|
36
37
|
const { version } = createRequire(import.meta.url)('./package.json');
|
|
37
38
|
const server = new McpServer({ name: 'firstch-tools', version });
|
|
@@ -1382,4 +1383,50 @@ server.registerTool(
|
|
|
1382
1383
|
},
|
|
1383
1384
|
);
|
|
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
|
+
|
|
1385
1432
|
await server.connect(new StdioServerTransport());
|