@first-ch/tools-mcp 0.4.0 → 0.24.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/server.mjs CHANGED
@@ -4,10 +4,29 @@
4
4
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
5
5
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
6
6
  import { z } from 'zod';
7
- import { appendFile } from 'node:fs/promises';
7
+ import { appendFile, writeFile } from 'node:fs/promises';
8
8
  import { createRequire } from 'node:module';
9
- import { contrastCheck, countChars, buildLlmsTxt, buildJsonLd } from './lib.mjs';
9
+ import { contrastCheck, countChars, buildLlmsTxt, buildJsonLd, analyzeEncoding, convertEncoding } from './lib.mjs';
10
+ import { generateTestData, FIELDS, DEFAULT_FIELDS, PRESETS } from './testdata.mjs';
10
11
  import { convertToWebp } from './webp.mjs';
12
+ import { renderMarp } from './marp.mjs';
13
+ import { diffCheck } from './diff.mjs';
14
+ import { cronExplain } from './cron.mjs';
15
+ import { base64Convert } from './base64.mjs';
16
+ import { urlParams } from './url.mjs';
17
+ import { htmlEscape } from './html-escape.mjs';
18
+ import { jsonToYaml, yamlToJson } from './json-yaml.mjs';
19
+ import { pxRemConvert } from './px-rem.mjs';
20
+ import { colorConvert } from './color.mjs';
21
+ import { hashGenerate } from './hash.mjs';
22
+ import { jwtDecode } from './jwt.mjs';
23
+ import { userAgentParse } from './user-agent.mjs';
24
+ import { uuidGenerate, MAX_COUNT as UUID_MAX_COUNT } from './uuid.mjs';
25
+ import { aspectRatioCalc } from './aspect-ratio.mjs';
26
+ import { markdownTable } from './markdown-table.mjs';
27
+ import { sqlFormatTool } from './sql-format.mjs';
28
+ import { qrGenerateTool } from './qr.mjs';
29
+ import { unixtimeConvert } from './unixtime.mjs';
11
30
 
12
31
  const { version } = createRequire(import.meta.url)('./package.json');
13
32
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -172,4 +191,925 @@ server.registerTool(
172
191
  },
173
192
  );
174
193
 
194
+ server.registerTool(
195
+ 'encoding_convert',
196
+ {
197
+ title: '文字コード・改行コード変換',
198
+ description:
199
+ 'CSV/テキストの文字コード(UTF-8 / Shift_JIS)・BOM有無・改行コード(CRLF/LF/CR)を判定し、UTF-8へ変換する。' +
200
+ '顧客から受け取ったCSVの文字化け調査、フォーム取り込みデータの前処理、' +
201
+ 'リポジトリ内ファイルの改行コード事故(CRLFがLFに書き換わる等)の確認に使う。' +
202
+ 'mode=analyze なら判定のみ、mode=convert なら変換後のテキストとbase64を返す。',
203
+ inputSchema: {
204
+ base64: z.string().describe('対象ファイルの内容(base64)。テキストを直接渡す場合は text を使う'),
205
+ text: z.string().optional().describe('base64の代わりにテキストを直接渡す場合(UTF-8として扱う)'),
206
+ mode: z.enum(['analyze', 'convert']).optional().describe('既定 analyze。convert で変換結果を返す'),
207
+ encoding: z.enum(['utf-8', 'shift_jis']).optional().describe('入力の文字コード。省略時は自動判定'),
208
+ newline: z.enum(['LF', 'CRLF', 'CR']).optional().describe('変換後の改行コード(mode=convert のとき)'),
209
+ bom: z.boolean().optional().describe('変換後にUTF-8 BOMを付けるか(既定 false)'),
210
+ },
211
+ },
212
+ async ({ base64, text, mode, encoding, newline, bom }) => {
213
+ await logUsage('encoding_convert');
214
+ if (!base64 && text === undefined) throw new Error('base64 か text のどちらかが必要です');
215
+ const bytes = base64
216
+ ? Uint8Array.from(Buffer.from(base64, 'base64'))
217
+ : new TextEncoder().encode(text);
218
+ if (mode === 'convert') return asText(convertEncoding(bytes, { encoding, newline, bom }));
219
+ const { text: _drop, ...info } = analyzeEncoding(bytes, encoding);
220
+ return asText(info);
221
+ },
222
+ );
223
+
224
+ server.registerTool(
225
+ 'marp_render',
226
+ {
227
+ title: 'Marp Markdown→スライド レンダリング',
228
+ description:
229
+ 'Marp Markdown をスライドへレンダリングし、HTML(テーマCSSをインラインした自己完結ファイル)や PDF を書き出す。' +
230
+ 'AIが生成したスライド用Markdownをそのまま渡せば描画まで完結する(社内の marp ビルドの定型化・顧客配布資料の生成に使う)。' +
231
+ '和文テーマ firstch(firstch-design 準拠・紙/墨/朱・IBM Plex Sans JP)を同梱し、既定テーマにする。' +
232
+ 'Markdown 側の Marp フロントマター(例: theme:/paginate:/size:/`<!-- _class: lead -->`)はそのまま効く。' +
233
+ 'PDF はローカルの Chrome/Chromium を headless で呼び出して生成する(未検出なら HTML のみ返し理由を添える。' +
234
+ '環境変数 MARP_CHROME_PATH で実行ファイルを明示可)。完全ローカル処理・ネットワーク送信なし。',
235
+ inputSchema: {
236
+ markdown: z.string().optional().describe('Marp Markdown 本文(inputPath と排他・どちらか必須)'),
237
+ inputPath: z.string().optional().describe('Markdownファイルの絶対パス(markdown 未指定時に読み込む)'),
238
+ theme: z
239
+ .enum(['firstch', 'default', 'gaia', 'uncover'])
240
+ .optional()
241
+ .describe('既定テーマ(既定 firstch=和文)。Markdown内の theme 指示が優先される'),
242
+ formats: z
243
+ .array(z.enum(['html', 'pdf']))
244
+ .optional()
245
+ .describe("出力フォーマット(既定 ['html'])。['html','pdf'] で両方"),
246
+ outputPath: z
247
+ .string()
248
+ .optional()
249
+ .describe('出力ファイルのベースパス(拡張子は自動。省略時は inputPath 準拠、無ければ一時ディレクトリ)'),
250
+ title: z.string().optional().describe('HTML の <title>(既定 "Marp slides")'),
251
+ },
252
+ },
253
+ async ({ markdown, inputPath, theme, formats, outputPath, title }) => {
254
+ await logUsage('marp_render');
255
+ let md = markdown;
256
+ let outBase = outputPath;
257
+ let docTitle = title;
258
+ if ((md === undefined || md === '') && inputPath) {
259
+ const { readFile } = await import('node:fs/promises');
260
+ const { basename, extname } = await import('node:path');
261
+ md = await readFile(inputPath, 'utf8');
262
+ if (!outBase) outBase = inputPath; // 既定は入力と同じ場所・同名
263
+ if (!docTitle) docTitle = basename(inputPath, extname(inputPath));
264
+ }
265
+ if (md === undefined || md === '') throw new Error('markdown か inputPath のどちらかが必要です');
266
+ return asText(await renderMarp(md, { theme, formats, outputPath: outBase, title: docTitle }));
267
+ },
268
+ );
269
+
270
+ server.registerTool(
271
+ 'testdata_generate',
272
+ {
273
+ title: 'テストデータ生成(ダミーCSV/JSON/Excel・境界値テキスト)',
274
+ description:
275
+ 'フォーム入力テスト・CSV取り込みテスト用のダミーデータを生成する。' +
276
+ 'mode=records(既定)は氏名・フリガナ・住所・郵便番号・メール・電話番号などをCSV/TSV/JSON/XLSXで返し、' +
277
+ '文字コード(UTF-8 / Shift_JIS)・BOM・改行コード(LF/CRLF)を指定できる。' +
278
+ 'format=xlsx は Excel の .xlsx ファイル(バイナリ)を base64 で返す。outputPath を併せて渡すとファイルに書き出せる。' +
279
+ 'mode=text は maxlength の境界値テスト用に、指定文字種で n-1 / n / n+1 文字ちょうどの文字列を返す。' +
280
+ '生成データはすべて架空(メールは RFC 2606 の example.com 系)。seed を渡すと同じデータを再現できる。',
281
+ inputSchema: {
282
+ mode: z.enum(['records', 'text']).optional().describe('既定 records。text は文字種・境界値テキスト'),
283
+ rows: z.number().int().min(1).max(1000).optional().describe('行数(既定10・最大1000)'),
284
+ fields: z
285
+ .array(z.enum(FIELDS))
286
+ .optional()
287
+ .describe(`出力する列(既定: ${DEFAULT_FIELDS.join(',')})。locale=en では name_kana / name_romaji は空になる`),
288
+ format: z.enum(['csv', 'tsv', 'json', 'xlsx']).optional().describe('出力形式(既定 csv)。xlsx は Excel ファイルを base64 で返す'),
289
+ locale: z.enum(['ja', 'en']).optional().describe('データの言語(既定 ja。氏名・住所・電話番号の体系が変わる)'),
290
+ encoding: z.enum(['utf-8', 'shift_jis']).optional().describe('文字コード(既定 utf-8)。shift_jis のときは base64 も返す。xlsx では無視される'),
291
+ newline: z.enum(['LF', 'CRLF']).optional().describe('改行コード(既定 LF)。xlsx では無視される'),
292
+ bom: z.boolean().optional().describe('UTF-8 BOMを付けるか(既定 false・Excelで開くCSV向け)。xlsx では無視される'),
293
+ header: z.boolean().optional().describe('ヘッダー行を付けるか(既定 true・csv/tsv/xlsxのみ)'),
294
+ seed: z.string().optional().describe('乱数シード。同じ値なら常に同じデータを生成する(省略時はランダム)'),
295
+ preset: z.enum(PRESETS).optional().describe('mode=text の文字種(既定 mixed)'),
296
+ length: z.number().int().min(1).max(10000).optional().describe('mode=text の文字数N(既定20・最大10000)'),
297
+ outputPath: z.string().optional().describe('指定するとその絶対パスへファイルとして書き出す(mode=records のみ・format=xlsx では実質必須)'),
298
+ },
299
+ },
300
+ async (opts) => {
301
+ await logUsage('testdata_generate');
302
+ const { _bytes, ...result } = generateTestData(opts);
303
+ if (opts.outputPath && result.mode === 'records') {
304
+ await writeFile(opts.outputPath, _bytes);
305
+ result.output = opts.outputPath;
306
+ // ファイルに書けたなら base64 は重複した重い情報でしかない
307
+ delete result.base64;
308
+ }
309
+ return asText(result);
310
+ },
311
+ );
312
+
313
+ server.registerTool(
314
+ 'diff_check',
315
+ {
316
+ title: 'テキスト・コード差分チェック',
317
+ description:
318
+ '2つのテキスト(またはファイル)を比較し、追加・削除・変更の件数と unified diff(.patch)を返す' +
319
+ '(tools.first-ch.com/diff/ と同一ロジック)。原稿の推敲差分の確認、コード修正のレビュー、' +
320
+ '設定ファイルの比較、AIが書き換えた文章の変更点の抽出に使う。' +
321
+ '行の対応づけは patience diff(両方に1回だけ現れる行をアンカーに分割)+アンカーの取れない範囲だけ Myers。' +
322
+ 'format=blocks / both では、変更行のペアを語単位(英数字はひとかたまり・和文は1文字ずつ)で比較した ' +
323
+ 'changed_parts も返すため、「どの語が変わったか」まで取れる。完全ローカル処理・ネットワーク送信なし。',
324
+ inputSchema: {
325
+ a: z.string().optional().describe('変更前のテキスト(pathA と排他・どちらか必須)'),
326
+ b: z.string().optional().describe('変更後のテキスト(pathB と排他・どちらか必須)'),
327
+ pathA: z.string().optional().describe('変更前ファイルの絶対パス(a 未指定時に読み込む・UTF-8)'),
328
+ pathB: z.string().optional().describe('変更後ファイルの絶対パス(b 未指定時に読み込む・UTF-8)'),
329
+ format: z
330
+ .enum(['unified', 'blocks', 'both'])
331
+ .optional()
332
+ .describe('既定 unified。blocks は変更ブロックの配列、both は両方'),
333
+ context: z.number().int().min(0).max(100).optional().describe('unified diff の前後コンテキスト行数(既定3)'),
334
+ ignoreWhitespace: z.boolean().optional().describe('空白の違いを無視するか(既定 false)'),
335
+ ignoreCase: z.boolean().optional().describe('大文字・小文字の違いを無視するか(既定 false)'),
336
+ words: z.boolean().optional().describe('語単位の変更点も求めるか(既定 true・format=blocks/both で返る)'),
337
+ },
338
+ },
339
+ async ({ a, b, pathA, pathB, format, context, ignoreWhitespace, ignoreCase, words }) => {
340
+ await logUsage('diff_check');
341
+ let textA = a;
342
+ let textB = b;
343
+ if (textA === undefined && pathA) {
344
+ const { readFile } = await import('node:fs/promises');
345
+ textA = await readFile(pathA, 'utf8');
346
+ }
347
+ if (textB === undefined && pathB) {
348
+ const { readFile } = await import('node:fs/promises');
349
+ textB = await readFile(pathB, 'utf8');
350
+ }
351
+ if (textA === undefined || textB === undefined) {
352
+ throw new Error('a/b(テキスト)か pathA/pathB(ファイルパス)で、両側の入力を渡してください');
353
+ }
354
+ return asText(
355
+ diffCheck(textA, textB, {
356
+ format,
357
+ context,
358
+ ignoreWhitespace,
359
+ ignoreCase,
360
+ words,
361
+ nameA: pathA || 'a',
362
+ nameB: pathB || 'b',
363
+ }),
364
+ );
365
+ },
366
+ );
367
+
368
+ server.registerTool(
369
+ 'cron_explain',
370
+ {
371
+ title: 'Cron式の解説+次回発火日時',
372
+ description:
373
+ 'Cron式(例: */15 * * * *)を人間向けの文へ読み下し、次回からの発火日時を返す' +
374
+ '(tools.first-ch.com/cron/ と同一ロジック)。バッチ・CI・スケジューラの設定レビュー、' +
375
+ '「この式は結局いつ動くのか」の確認、書き間違いの検出に使う。解釈は Vixie cron(crontab(5))準拠で、' +
376
+ '範囲・ステップ・列挙・JAN-DEC / SUN-SAT の名前・@daily 等の省略記法に対応し、6フィールドのときは先頭を秒として扱う。' +
377
+ '「日」と「曜日」の両方が指定されたときの OR 解釈、範囲を割り切らない */n、存在しない日付(2月30日など)は warnings で知らせる。' +
378
+ '発火日時はタイムゾーンの壁時計上で求めてから実時刻へ戻すため、夏時間のある地域でもずれない。完全ローカル処理・ネットワーク送信なし。',
379
+ inputSchema: {
380
+ expression: z.string().describe('Cron式(5フィールド「分 時 日 月 曜日」/ 秒付き6フィールド / @daily 等)'),
381
+ timeZone: z
382
+ .string()
383
+ .optional()
384
+ .describe('発火日時を求めるタイムゾーン(IANA名。既定 UTC。例: Asia/Tokyo)'),
385
+ count: z.number().int().min(1).max(100).optional().describe('返す発火日時の件数(既定5・最大100)'),
386
+ from: z.string().optional().describe('この日時より後を探す(ISO8601。既定は現在時刻)'),
387
+ },
388
+ },
389
+ async ({ expression, timeZone, count, from }) => {
390
+ await logUsage('cron_explain');
391
+ return asText(cronExplain(expression, { timeZone, count, from }));
392
+ },
393
+ );
394
+
395
+ server.registerTool(
396
+ 'base64_encode',
397
+ {
398
+ title: 'Base64 / Data URI エンコード・デコード',
399
+ description:
400
+ 'テキストやファイルを Base64・data URI へ変換し、そのまま貼れる HTML <img> / CSS background-image の' +
401
+ 'スニペットも返す(tools.first-ch.com/base64/ と同一ロジック)。mode="decode" では Base64 や data URI を' +
402
+ '元のバイト列へ戻し、outputPath を渡せばファイルとして書き出す。' +
403
+ 'アイコンやSVGのCSS埋め込み、メールHTML用の画像インライン化、APIやJWTで受け取ったBase64の中身の確認、' +
404
+ 'ログに出てきたdata URIの復元に使う。' +
405
+ 'SVGは base64(必ず約1.33倍になる)よりパーセントエンコードの方が小さいため両方の長さを返して短い方を既定にし、' +
406
+ '& " < > # % と空白・非ASCIIを必ずエスケープするのでHTML属性にもCSSの url("…") にもそのまま貼れる。' +
407
+ 'デコードは標準/URLセーフのどちらでも、空白・改行混じりでも、パディングが欠けていても読み取り、' +
408
+ 'data URI が名乗るMIMEタイプより実際のマジックナンバー(PNG/JPEG/GIF/WebP/ico/PDF/zip/woff/woff2/SVG)から' +
409
+ '判定した種類を優先する。完全ローカル処理・ネットワーク送信なし。',
410
+ inputSchema: {
411
+ mode: z.enum(['encode', 'decode']).optional().describe('既定 encode。decode は base64 を元のバイト列へ戻す'),
412
+ text: z.string().optional().describe('encode: 変換するテキスト(UTF-8として符号化する。path と排他)'),
413
+ path: z.string().optional().describe('encode: 変換するファイルの絶対パス(text と排他)'),
414
+ base64: z.string().optional().describe('decode: Base64本体、または data:…;base64,… の全体'),
415
+ outputPath: z.string().optional().describe('decode: 復元したバイト列を書き出す絶対パス(指定すると base64 は返さない)'),
416
+ urlSafe: z.boolean().optional().describe('encode: URLセーフ(+/ を -_ に・パディング無し)にするか(既定 false)'),
417
+ wrap: z.number().int().min(1).max(998).optional().describe('encode: n桁ごとに改行する(MIMEは76)'),
418
+ dataUri: z.boolean().optional().describe('encode: data URI も返すか(path 指定時は常に返す)'),
419
+ mimeType: z.string().optional().describe('encode: data URI のMIMEタイプ(未指定なら中身から判定)'),
420
+ snippets: z.boolean().optional().describe('encode: HTML <img> / CSS background-image のスニペットも返すか(画像のみ)'),
421
+ },
422
+ },
423
+ async (opts) => {
424
+ await logUsage('base64_encode');
425
+ return asText(await base64Convert(opts));
426
+ },
427
+ );
428
+
429
+ server.registerTool(
430
+ 'url_params',
431
+ {
432
+ title: 'URLパラメータの分解・編集・再構築',
433
+ description:
434
+ 'URLのクエリ文字列をキーと値へ分解し、編集・追加・削除・並べ替えをして再構築する' +
435
+ '(tools.first-ch.com/url/ と同一ロジック)。UTMタグの付与、gclid等のクリックIDの一括削除、' +
436
+ '文字列単体のURLエンコード/デコード(mode="encode" / "decode")もできる。' +
437
+ 'リダイレクトURLやAPI引数の中身の確認、計測用URLの作成、共有前のクエリの掃除に使う。' +
438
+ '値はデコードして返し(%XX を元の文字へ、+ を半角スペースへ)、編集していないパラメータは' +
439
+ '生の文字列のまま書き戻すため、何も指定しなければ再構築後のURLは入力と1バイトも変わらない' +
440
+ '(署名付きURLを通しても壊れない)。reencode=true で全体を encodeURIComponent の規則へ正規化する。' +
441
+ '重複キー・未エンコードのスペースや非ASCII・壊れた %XX・+ のスペース解釈・UTM値の大文字混在や' +
442
+ 'source/mediumの片落ち・URL内のパスワード・トークンらしきキー・2000文字超を warnings で知らせる。' +
443
+ '相対パスや壊れたパーセントエンコードでも例外にせず、読める範囲まで分解する。' +
444
+ '完全ローカル処理・ネットワーク送信なし(URLへのアクセスは行わない)。',
445
+ inputSchema: {
446
+ url: z.string().optional().describe('mode="parse": 分解するURL(相対パス・部分的なURLも可)'),
447
+ mode: z
448
+ .enum(['parse', 'encode', 'decode'])
449
+ .optional()
450
+ .describe('既定 parse。encode/decode は url ではなく text を対象にする'),
451
+ text: z.string().optional().describe('mode="encode"/"decode": 対象の文字列'),
452
+ scheme: z
453
+ .enum(['component', 'uri', 'form'])
454
+ .optional()
455
+ .describe('encode/decode の方式(既定 component=encodeURIComponent / uri=encodeURI / form=スペースを +)'),
456
+ set: z.record(z.string()).optional().describe('parse: 追加・上書きするパラメータ(値が空文字なら削除)'),
457
+ remove: z.array(z.string()).optional().describe('parse: 削除するパラメータ名(大文字小文字を無視)'),
458
+ utm: z
459
+ .record(z.string())
460
+ .optional()
461
+ .describe('parse: UTMタグ。source / medium / campaign / content / term / id(utm_ 付きでも可)'),
462
+ removeTracking: z.boolean().optional().describe('parse: gclid・fbclid 等のクリックIDを一括削除する'),
463
+ sort: z.boolean().optional().describe('parse: パラメータを名前順に並べ替える'),
464
+ reencode: z.boolean().optional().describe('parse: 全パラメータを encodeURIComponent の規則で書き直す'),
465
+ spaceAsPlus: z.boolean().optional().describe('parse: 新たにエンコードする値のスペースを %20 ではなく + にする'),
466
+ },
467
+ },
468
+ async (opts) => {
469
+ await logUsage('url_params');
470
+ return asText(urlParams(opts));
471
+ },
472
+ );
473
+
474
+ server.registerTool(
475
+ 'html_escape',
476
+ {
477
+ title: 'HTML特殊文字のエスケープ・エンティティのデコード',
478
+ description:
479
+ 'テキスト中の < > & " \' をHTMLエンティティへ変換し、逆に &amp; &#39; &#x3042; などの文字参照を' +
480
+ '元の文字へ戻す(tools.first-ch.com/html-escape/ と同一ロジック)。' +
481
+ '記事やコード例へHTMLをそのまま載せる、テンプレートへ差し込む値を安全にする、' +
482
+ 'スクレイピングやAPIで受け取ったエンティティ混じりのテキストを読める形に戻す、といった用途に使う。' +
483
+ 'エスケープは & を最初に処理するため何度実行しても二重エスケープにならず、' +
484
+ '名前付き参照と数値文字参照(10進・16進)を切り替えられる。' +
485
+ 'デコードはHTML 4.01の名前付き文字参照252個すべてと10進/16進に対応し、' +
486
+ '知らない名前や範囲外の数値は推測で変換せずそのまま残して notes で知らせる。' +
487
+ '&#128; のようなC1領域の数値参照はHTML仕様どおり Windows-1252 の文字(€)へ読み替える。' +
488
+ 'すでにエスケープ済みの入力・裸の &・セミコロンで閉じていない参照・ノーブレークスペース(U+00A0)の' +
489
+ '混入も notes で指摘する。完全ローカル処理・ネットワーク送信なし。',
490
+ inputSchema: {
491
+ mode: z.enum(['escape', 'unescape']).optional().describe('既定 escape。unescape はエンティティを元の文字へ戻す'),
492
+ text: z.string().optional().describe('対象のテキスト(path と排他)'),
493
+ path: z.string().optional().describe('対象ファイルの絶対パス(UTF-8として読む。text と排他)'),
494
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると text は返さない)'),
495
+ quotes: z.boolean().optional().describe('escape: " と \' も変換するか(既定 true。属性値へ入れるなら必須)'),
496
+ apos: z.boolean().optional().describe("escape: ' を &apos; にするか(既定 false=&#39;。&apos; はHTML 4.01に無い)"),
497
+ numeric: z.boolean().optional().describe('escape: 名前ではなく数値文字参照(&#38; 形式)で出力するか(既定 false)'),
498
+ nonAscii: z
499
+ .enum(['none', 'named', 'decimal', 'hex'])
500
+ .optional()
501
+ .describe('escape: 非ASCII文字の扱い(既定 none。文字コードが伝わらない経路へ渡すなら decimal/hex)'),
502
+ },
503
+ },
504
+ async (opts) => {
505
+ await logUsage('html_escape');
506
+ return asText(await htmlEscape(opts));
507
+ },
508
+ );
509
+
510
+ // JSON ⇄ YAML は「入力の形式」ごとに別ツールにしている(direction を間違えると
511
+ // 何も変換されないまま返ってしまうため、名前で向きが決まる方が誤用しにくい)。
512
+ const JSON_YAML_SHARED =
513
+ '変換は完全ローカル処理・ネットワーク送信なし。text か path のどちらか一方を渡す。' +
514
+ 'outputPath を渡すとファイルへ書き出す(本文は返さない)。' +
515
+ '構文エラーのときは「何行何桁・原因・直し方」と、その前後2行の抜き出しをエラーとして返すので、' +
516
+ '設定ファイルの構文チェックにも使える。' +
517
+ '読み替えで意味が変わる箇所は notes で知らせる(キーの重複=後が勝つ・2の53乗を超える整数の桁落ちなど)。';
518
+
519
+ server.registerTool(
520
+ 'json_to_yaml',
521
+ {
522
+ title: 'JSON → YAML 変換・整形',
523
+ description:
524
+ 'JSONをYAMLへ変換して整形する(tools.first-ch.com/json-yaml/ と同一ロジック)。' +
525
+ 'APIレスポンスやテンプレートの出力を docker-compose・GitHub Actions・Kubernetes マニフェストのような' +
526
+ '設定ファイルへ写すときに使う。インデント幅・引用符の付け方・null の書き方・複数行文字列を' +
527
+ 'ブロックスカラー(|)で書くか・キーを名前順に並べるか・先頭に --- を付けるかを選べる。' +
528
+ '別の型に読まれうる文字列(yes / no / on / off / 0755 / 12:30 / 2026-08-12 / 数値に見える文字列)、' +
529
+ '前後に空白がある文字列、- や * や # で始まる文字列は自動で引用符を付けるので、' +
530
+ 'YAML 1.1 のパーサ(PyYAMLなど)に渡しても意味が変わらない。' +
531
+ '改行を含む文字列は | のブロック表記にし、行末の空白など復元できない形のときだけ "…" に倒す。' +
532
+ 'コメント・末尾カンマ・シングルクォート・引用符なしのキーを含むJSON(tsconfig.json など)も' +
533
+ '読み取って変換し、JSONとしては不正であることを notes で知らせる(relaxed=false で厳密に拒否できる)。' +
534
+ JSON_YAML_SHARED,
535
+ inputSchema: {
536
+ text: z.string().optional().describe('変換するJSON(path と排他)'),
537
+ path: z.string().optional().describe('変換するJSONファイルの絶対パス(UTF-8として読む。text と排他)'),
538
+ outputPath: z.string().optional().describe('YAMLを書き出す絶対パス(指定すると text は返さない)'),
539
+ indent: z.number().int().min(1).max(8).optional().describe('YAMLのインデント幅(既定2)'),
540
+ quote: z
541
+ .enum(['auto', 'single', 'double'])
542
+ .optional()
543
+ .describe("引用符の付け方(既定 auto=必要なときだけ / single='…' / double=\"…\")"),
544
+ nullStyle: z.enum(['null', 'tilde', 'empty']).optional().describe('null の書き方(既定 null / tilde=~ / empty=空欄)'),
545
+ block: z.boolean().optional().describe('改行を含む文字列を | のブロック表記で書くか(既定 true)'),
546
+ sortKeys: z.boolean().optional().describe('キーを名前順に並べるか(既定 false=入力の順)'),
547
+ docStart: z.boolean().optional().describe('先頭に --- を付けるか(既定 false)'),
548
+ relaxed: z.boolean().optional().describe('コメント・末尾カンマ等を含むJSONも読むか(既定 true)'),
549
+ },
550
+ },
551
+ async (opts) => {
552
+ await logUsage('json_to_yaml');
553
+ return asText(await jsonToYaml(opts));
554
+ },
555
+ );
556
+
557
+ server.registerTool(
558
+ 'yaml_to_json',
559
+ {
560
+ title: 'YAML → JSON 変換・構文チェック',
561
+ description:
562
+ 'YAMLをJSONへ変換する(tools.first-ch.com/json-yaml/ と同一ロジック)。' +
563
+ 'docker-compose・GitHub Actions・Kubernetes マニフェスト・CIの設定を、プログラムから扱える形へ' +
564
+ '読み替えるときや、構文の妥当性を確かめるときに使う。インデント2/4/タブ/1行(indent=0)を選べ、' +
565
+ 'キーの並べ替えと非ASCII文字の \\uXXXX 化もできる。' +
566
+ '複数ドキュメント(--- 区切り)はJSONの配列1つにまとめ、アンカー &名前 / エイリアス *名前 /' +
567
+ 'マージキー << は展開する(JSONに参照の仕組みが無いため。展開したことは notes で知らせる)。' +
568
+ 'スカラーの解釈は YAML 1.2 core schema に従うので yes / no / on / off / NO は文字列のままだが、' +
569
+ 'YAML 1.1 のパーサでは真偽値になる値、0755(10進の755になる)、12:30(60進数の750になる)、' +
570
+ '日付に見える値は notes で知らせる。' +
571
+ '対応: ブロックマップ/シーケンス・フロー表記 [] {}・引用スカラー(複数行・エスケープ)・' +
572
+ 'ブロックスカラー | > と chomping - + と明示インデント・タグ(!!str !!int !!float !!bool !!null !!binary)・コメント。' +
573
+ '未対応は「? キー」の明示キー記法のみ。' +
574
+ JSON_YAML_SHARED,
575
+ inputSchema: {
576
+ text: z.string().optional().describe('変換するYAML(path と排他)'),
577
+ path: z.string().optional().describe('変換するYAMLファイルの絶対パス(UTF-8として読む。text と排他)'),
578
+ outputPath: z.string().optional().describe('JSONを書き出す絶対パス(指定すると text は返さない)'),
579
+ indent: z
580
+ .union([z.number().int().min(0).max(8), z.literal('tab')])
581
+ .optional()
582
+ .describe('JSONのインデント(既定2 / 0=改行なしの1行 / "tab"=タブ)'),
583
+ sortKeys: z.boolean().optional().describe('キーを名前順に並べるか(既定 false=入力の順)'),
584
+ ascii: z.boolean().optional().describe('非ASCII文字を \\uXXXX へエスケープするか(既定 false)'),
585
+ },
586
+ },
587
+ async (opts) => {
588
+ await logUsage('yaml_to_json');
589
+ return asText(await yamlToJson(opts));
590
+ },
591
+ );
592
+
593
+ server.registerTool(
594
+ 'px_rem_convert',
595
+ {
596
+ title: 'px ⇄ rem / em 単位換算・CSSの一括変換',
597
+ description:
598
+ 'CSSの長さの単位を px ⇄ rem / em / pt で換算する(tools.first-ch.com/px-rem/ と同一ロジック)。' +
599
+ 'value を渡すと1つの値の換算になり、px・rem・em・pt の値と、そのまま貼れる font-size の1行、' +
600
+ 'よく使うフォントサイズ(12〜64px)のスケール表を返す。' +
601
+ 'css か path を渡すとCSS全体の一括変換になり、px→rem(px2rem)のほか px2em / rem2px / em2px を選べる。' +
602
+ 'デザインカンプのpx指定をremへ直す、既存のスタイルシートをアクセシビリティのためにrem化する、' +
603
+ 'rem表記のCSSを実寸で確かめる、といった用途に使う。' +
604
+ '一括変換ではコメント・文字列(content: "10px")・url() の中身と、--size-16px のように' +
605
+ '識別子の一部になっている数字は書き換えない。既定では minPx=2 で1pxの罫線を残し(remにすると' +
606
+ '環境によって太さがばらつくため)、@media などアットルールの条件(ブレークポイント)も変換しない。' +
607
+ 'ルートは 62.5% のようなパーセントでも指定でき、その場合はブラウザ既定16pxに対する割合として読む。' +
608
+ '割り切れない値は丸めたことを notes で知らせる。完全ローカル処理・ネットワーク送信なし。',
609
+ inputSchema: {
610
+ value: z
611
+ .union([z.number(), z.string()])
612
+ .optional()
613
+ .describe('換算する1つの値(24 / "24px" / "1.5rem" のように単位を含めてもよい。css / path と排他)'),
614
+ unit: z
615
+ .enum(['px', 'rem', 'em', 'pt', '%'])
616
+ .optional()
617
+ .describe('value の単位(既定 px。value に単位を書いた場合はそちらが優先)'),
618
+ css: z.string().optional().describe('一括変換するCSS(value / path と排他)'),
619
+ path: z.string().optional().describe('一括変換するCSSファイルの絶対パス(UTF-8として読む。value / css と排他)'),
620
+ outputPath: z.string().optional().describe('変換後のCSSを書き出す絶対パス(指定すると本文は返さない)'),
621
+ direction: z
622
+ .enum(['px2rem', 'px2em', 'rem2px', 'em2px'])
623
+ .optional()
624
+ .describe('一括変換の向き(既定 px2rem)'),
625
+ root: z
626
+ .union([z.number(), z.string()])
627
+ .optional()
628
+ .describe('ルート(html要素)のフォントサイズ px(既定16。"62.5%" のような指定も可)'),
629
+ parent: z
630
+ .union([z.number(), z.string()])
631
+ .optional()
632
+ .describe('親要素のフォントサイズ px(em の基準。既定は root と同じ)'),
633
+ precision: z
634
+ .union([z.number().int().min(0).max(6), z.literal('auto')])
635
+ .optional()
636
+ .describe('小数の桁(既定 auto=6桁まで見て末尾の0を落とす。数値を渡すとその桁で固定)'),
637
+ minPx: z
638
+ .number()
639
+ .optional()
640
+ .describe('一括変換で、換算後の絶対値がこの px 未満の値は変換しない(既定2=1pxの罫線を残す。0で全部変換)'),
641
+ zeroUnitless: z.boolean().optional().describe('0 を単位なしの 0 にするか(既定 true)'),
642
+ skipMedia: z.boolean().optional().describe('@media などアットルールの条件を変換対象から外すか(既定 true)'),
643
+ ignoreProps: z
644
+ .array(z.string())
645
+ .optional()
646
+ .describe('変換しないプロパティ(前方一致。例 ["border","outline","box-shadow"])'),
647
+ scale: z.boolean().optional().describe('値の換算のときに12〜64pxのスケール表を返すか(既定 true)'),
648
+ },
649
+ },
650
+ async (opts) => {
651
+ await logUsage('px_rem_convert');
652
+ return asText(await pxRemConvert(opts));
653
+ },
654
+ );
655
+
656
+ server.registerTool(
657
+ 'color_convert',
658
+ {
659
+ title: 'カラーコード変換・アルファ透過計算',
660
+ description:
661
+ '色のコードを HEX / RGB / HSL / OKLCH で相互変換し、アルファ(透過度)付きの rgba() / hsla() / 8桁HEX を返す' +
662
+ '(tools.first-ch.com/color/ と同一ロジック)。' +
663
+ '入力は HEX(3/4/6/8桁)・rgb()・hsl()・hwb()・oklch()・oklab()・CSSの名前付き色(148色)・transparent を受け付け、' +
664
+ '旧記法のカンマ区切りと新記法のスラッシュ区切り、角度の単位(deg / grad / rad / turn)も読む。' +
665
+ 'background を渡すと、透過色をその背景の上に重ねたときに実際に見える色(アルファ合成の結果)を flattened で返すので、' +
666
+ 'デザインカンプの半透明レイヤーを不透明なHEXへ置き換える用途に使える。' +
667
+ 'あわせて白文字・黒文字とのWCAG 2.1コントラスト比、アルファを刻んだ表(alpha_table)、' +
668
+ '色相と彩度を保ったまま明度だけを50〜950の11段に振った明度パレット(palette)を返す。' +
669
+ 'sRGBで表現できないOKLCHは、RGBを切り詰めると色相がずれるため、明度と色相を保ったまま彩度だけを下げて収める。' +
670
+ '完全ローカル処理・ネットワーク送信なし。',
671
+ inputSchema: {
672
+ color: z
673
+ .string()
674
+ .describe('変換する色("#c8501f" / "rgb(200 80 31)" / "hsl(17 73% 45%)" / "oklch(56% 0.16 41)" / "tomato" など)'),
675
+ alpha: z
676
+ .union([z.number(), z.string()])
677
+ .optional()
678
+ .describe('アルファ(0〜1・0〜100・"50%" のいずれか。指定すると color 側のアルファを上書きする)'),
679
+ background: z
680
+ .string()
681
+ .optional()
682
+ .describe('重ねる背景色(既定 #ffffff)。flattened と alpha_table の合成結果に使う'),
683
+ syntax: z
684
+ .enum(['modern', 'legacy'])
685
+ .optional()
686
+ .describe('rgb(200 80 31 / 50%) のモダン記法(既定)か、rgba(200, 80, 31, 0.5) の従来記法か'),
687
+ uppercase: z.boolean().optional().describe('HEXを大文字で書き出すか(既定 false)'),
688
+ alphaPercent: z.boolean().optional().describe('アルファをパーセントで書くか(既定 false=0〜1)'),
689
+ step: z.number().optional().describe('alpha_table の刻み(%・1〜50。既定10)'),
690
+ alphaTable: z.boolean().optional().describe('アルファを刻んだ表を返すか(既定 true)'),
691
+ palette: z.boolean().optional().describe('明度パレット(50〜950の11段)を返すか(既定 true)'),
692
+ },
693
+ },
694
+ async (opts) => {
695
+ await logUsage('color_convert');
696
+ return asText(colorConvert(opts));
697
+ },
698
+ );
699
+
700
+ server.registerTool(
701
+ 'hash_generate',
702
+ {
703
+ title: 'MD5 / SHA-1 / SHA-256 / SHA-384 / SHA-512 ハッシュ生成・照合',
704
+ description:
705
+ 'テキストまたはファイルの MD5・SHA-1・SHA-256・SHA-384・SHA-512 ハッシュ値を一度に算出する' +
706
+ '(tools.first-ch.com/hash/ と同一の仕様)。' +
707
+ 'ダウンロードしたファイルが配布元のチェックサムと一致するかの確認、変更の検出、' +
708
+ 'APIリクエストの署名計算の下ごしらえ、キャッシュキーの生成といった用途に使う。' +
709
+ 'expected に期待値を渡すと桁数から対象のアルゴリズムを判定して照合し、一致したかどうかを返す。' +
710
+ 'expected は `sha256sum` の出力(`<ハッシュ値>␣␣<ファイル名>`)・`SHA256 (file) = …`・' +
711
+ '`sha256:` のような接頭辞付き・コロン区切りの16進・Base64 をそのまま渡せる。' +
712
+ '出力は16進の小文字/大文字・Base64・base64url を選べる。' +
713
+ 'text は改行コード(lf / crlf)とUTF-8のBOMの有無を指定できるので、Windowsで作られたファイルの' +
714
+ '値も再現できる(文字コードはUTF-8固定)。ファイルは大きくてもストリームで1パス処理する。' +
715
+ 'MD5とSHA-1は衝突耐性が破られており署名・改ざん検知には使えないこと、ハッシュ値をそのまま' +
716
+ 'パスワード保存に使ってはいけないこと(ソルト付きのbcrypt / scrypt / Argon2を使う)は notes で知らせる。' +
717
+ '完全ローカル処理・ネットワーク送信なし。',
718
+ inputSchema: {
719
+ text: z.string().optional().describe('ハッシュ値を計算するテキスト(path と排他)'),
720
+ path: z.string().optional().describe('ハッシュ値を計算するファイルの絶対パス(text と排他)'),
721
+ algorithms: z
722
+ .array(z.enum(['md5', 'sha1', 'sha256', 'sha384', 'sha512']))
723
+ .optional()
724
+ .describe('算出するアルゴリズム(既定 ["md5","sha1","sha256","sha512"])'),
725
+ format: z
726
+ .enum(['hex', 'HEX', 'base64', 'base64url'])
727
+ .optional()
728
+ .describe('出力の書式(既定 hex=16進の小文字 / HEX=16進の大文字 / base64 / base64url)'),
729
+ newline: z
730
+ .enum(['lf', 'crlf'])
731
+ .optional()
732
+ .describe('text の改行コード(既定 lf。Windowsのファイルと突き合わせるなら crlf。path には影響しない)'),
733
+ bom: z.boolean().optional().describe('text の先頭にUTF-8のBOMを付けるか(既定 false。path には影響しない)'),
734
+ expected: z.string().optional().describe('照合するハッシュ値(コマンドの出力をそのまま渡してよい)'),
735
+ },
736
+ },
737
+ async (opts) => {
738
+ await logUsage('hash_generate');
739
+ return asText(await hashGenerate(opts));
740
+ },
741
+ );
742
+
743
+ server.registerTool(
744
+ 'jwt_decode',
745
+ {
746
+ title: 'JWTのデコード・有効期限チェック・署名の検証',
747
+ description:
748
+ 'JWT(JSON Web Token)をデコードしてヘッダーとペイロードを返し、有効期限(exp / nbf / iat)を判定する' +
749
+ '(tools.first-ch.com/jwt/ と同一の仕様)。' +
750
+ '開発中の認証トークンの中身の確認、「なぜ401になるのか」の切り分け、期限切れかどうかの判定に使う。' +
751
+ 'token は `Authorization: Bearer <token>` のヘッダー1行のまま渡してよい(前後の引用符・改行も除去する)。' +
752
+ 'key を渡すと署名も検証する: HS256/384/512 は共有鍵の文字列(keyEncoding で base64url / hex も可)、' +
753
+ 'RS・PS・ES・EdDSA は SPKI形式のPEM公開鍵、またはJWK / JWKS のJSON(JWKSはヘッダーの kid で自動的に選ぶ)。' +
754
+ '秘密鍵・証明書・PKCS#1 を渡した場合は検証せず、正しい取り出し方を返す。' +
755
+ 'clockTolerance で時計のズレを秒単位で許容でき、now でUNIX秒の現在時刻を固定できる(再現テスト用)。' +
756
+ 'alg:none・署名なし・期限切れ・nbfが未来・expがミリ秒(Date.now()の入れ間違い)・有効期間が長すぎる・' +
757
+ 'ペイロードに秘密情報や個人情報が入っている、といった落とし穴は warnings で知らせる。' +
758
+ '5セグメントのJWE(暗号化トークン)はヘッダーのみ返す(復号は行わない)。' +
759
+ '完全ローカル処理・ネットワーク送信なし(JWKSの取得も行わないので、鍵は呼び出し側が渡す)。',
760
+ inputSchema: {
761
+ token: z.string().describe('デコードするJWT(`Authorization: Bearer …` の1行のままでも可)'),
762
+ key: z
763
+ .string()
764
+ .optional()
765
+ .describe('署名の検証に使う鍵。HS*は共有鍵の文字列、その他はPEM公開鍵かJWK / JWKSのJSON(省略すると検証しない)'),
766
+ keyEncoding: z
767
+ .enum(['utf8', 'base64url', 'base64', 'hex'])
768
+ .optional()
769
+ .describe('HS* の共有鍵の読み方(既定 utf8=そのままの文字列)'),
770
+ clockTolerance: z.number().optional().describe('許容する時計のズレ(秒。既定0)'),
771
+ now: z.number().optional().describe('判定に使う現在時刻(UNIX秒。既定は実時刻)'),
772
+ },
773
+ },
774
+ async (opts) => {
775
+ await logUsage('jwt_decode');
776
+ return asText(await jwtDecode(opts));
777
+ },
778
+ );
779
+
780
+ server.registerTool(
781
+ 'user_agent_parse',
782
+ {
783
+ title: 'User-Agent文字列の解析とデバイス判定',
784
+ description:
785
+ 'User-Agent文字列から、ブラウザ名とバージョン・レンダリングエンジン・OSとそのバージョン・' +
786
+ 'デバイス種別(desktop / mobile / tablet / tv / console / wearable / bot)・メーカーと機種・' +
787
+ 'CPUアーキテクチャを判定する(tools.first-ch.com/user-agent/ と同一の仕様)。' +
788
+ 'アクセスログの調査、問い合わせに付いてきたUAの読み解き、対応ブラウザの棚卸しに使う。' +
789
+ 'ua はアクセスログの行のまま渡してよい(先頭の `User-Agent:`・前後の引用符・末尾のカンマは除去する)。' +
790
+ 'uas に配列を渡すと複数件をまとめて解析し、ブラウザ・OS・デバイス種別の内訳を summary で返す。' +
791
+ '判定は「より限定的なトークンから先に試す」順序で行う(Edg/ → OPR/ → Chrome/ → Safari/)。' +
792
+ 'Chrome・Edge・Opera はいずれも `Safari/` と `Chrome/` を名乗るため、部分一致では取り違える。' +
793
+ 'tokens でUA文字列をトークン単位に分解し、`Mozilla/5.0` や `KHTML, like Gecko` のような化石の意味を返す。' +
794
+ 'notes では「UAでは分からないこと」を知らせる: Chrome 110以降の削減済みUA(マイナー版は 0.0.0、' +
795
+ 'Androidの機種名は `K` に凍結)、macOSが常に 10.15.7 を名乗ること、Windows 10と11が区別できないこと、' +
796
+ 'iPadがMac版Safariと同じUAを送ること、アプリ内ブラウザ(LINE / Instagram / Facebook / Android WebView)、' +
797
+ 'そしてUAは誰でも名乗れるためアクセス制御の根拠にできないこと。' +
798
+ 'Googlebot・GPTBot・ClaudeBot などのクローラーや curl・python-requests のHTTPクライアントも判定する。' +
799
+ '完全ローカル処理・ネットワーク送信なし。',
800
+ inputSchema: {
801
+ ua: z.string().optional().describe('解析するUser-Agent文字列(`User-Agent:` 付きのログ1行のままでも可)'),
802
+ uas: z
803
+ .array(z.string())
804
+ .optional()
805
+ .describe('複数件をまとめて解析する場合のUA文字列の配列(内訳の集計 summary が付く。ua とは併用しない)'),
806
+ includeTokens: z
807
+ .boolean()
808
+ .optional()
809
+ .describe('uas で解析するときにトークン内訳を含めるか(既定: 20件以下なら含める)'),
810
+ },
811
+ },
812
+ async (opts) => {
813
+ await logUsage('user_agent_parse');
814
+ return asText(userAgentParse(opts));
815
+ },
816
+ );
817
+
818
+ server.registerTool(
819
+ 'uuid_generate',
820
+ {
821
+ title: 'UUID v4 / ULID の一括生成',
822
+ description:
823
+ 'UUID v4 または ULID を1〜100件まとめて生成する(tools.first-ch.com/uuid/ と同一の仕様)。' +
824
+ 'テストデータやマイグレーションの一意なIDの発行、DBのダミーレコード作成に使う。' +
825
+ 'UUID v4 は128bitのうち122bitが乱数(残る6bitがバージョン4とバリアント)で、順序を持たない。' +
826
+ 'ULID は26文字で、先頭10文字が生成時刻(UNIX時間のミリ秒・48bit)、後ろ16文字が乱数(80bit)。' +
827
+ '時刻が先頭にあるため文字列の辞書順が生成順と一致し、IDから作成日時を読み戻せる' +
828
+ '(DBの主キーにするとB+treeインデックスの断片化を避けやすい。ただし生成時刻は誰にでも読める)。' +
829
+ '同一ミリ秒内に複数生成するときは ULID 仕様の単調増加(monotonic)に従って乱数部を+1するため、' +
830
+ '100件を一度に作っても順序が崩れない。' +
831
+ '乱数は node:crypto の randomBytes(CSPRNG)で、Math.random は使わない。' +
832
+ 'format で出力の形(1行1件 / JSON配列 / カンマ区切り / SQLのINSERT向けの引用符付き)を、' +
833
+ 'uppercase・hyphens・braces で表記(UUIDの既定は RFC 9562 に従い小文字・ULIDの既定は大文字)を選べる。' +
834
+ '完全ローカル処理・ネットワーク送信なし。',
835
+ inputSchema: {
836
+ type: z.enum(['uuid', 'ulid']).optional().describe("生成するIDの種類(既定: 'uuid' = UUID v4)"),
837
+ count: z.number().int().optional().describe(`生成する件数(1〜${UUID_MAX_COUNT}。既定: 1)`),
838
+ format: z
839
+ .enum(['plain', 'json', 'csv', 'quoted'])
840
+ .optional()
841
+ .describe("text の出力形式(plain=1行1件 / json=JSON配列 / csv=カンマ区切り / quoted=\"…\", 。既定: plain)"),
842
+ uppercase: z.boolean().optional().describe('大文字にするか(既定: UUIDは false・ULIDは true)'),
843
+ hyphens: z.boolean().optional().describe('UUIDのハイフンを残すか(false で32文字。既定: true。ULIDでは無視)'),
844
+ braces: z.boolean().optional().describe('UUIDを波括弧で括るか(WindowsのGUID表記。既定: false。ULIDでは無視)'),
845
+ timestamp: z
846
+ .union([z.string(), z.number()])
847
+ .optional()
848
+ .describe('ULIDに埋め込む時刻(ISO8601文字列 / UNIX秒 / UNIXミリ秒。既定: 現在時刻。UUIDでは指定できない)'),
849
+ },
850
+ },
851
+ async (opts) => {
852
+ await logUsage('uuid_generate');
853
+ return asText(uuidGenerate(opts));
854
+ },
855
+ );
856
+
857
+ server.registerTool(
858
+ 'aspect_ratio_calc',
859
+ {
860
+ title: 'アスペクト比の計算・レスポンシブサイズ算出',
861
+ description:
862
+ 'アスペクト比と寸法を相互に計算する(tools.first-ch.com/aspect-ratio/ と同一ロジック)。' +
863
+ "ratio('16:9' / '16/9' / '1.85')と width か height の片方を渡すと、もう一方の寸法を返す。" +
864
+ 'width と height を渡して ratio を省くと、最大公約数で約分した比率・小数・向き・画素数と、' +
865
+ 'いちばん近い定番比率(16:9・4:3・3:2・1:1・4:5・9:16・21:9・1.85:1・2.39:1・1.91:1(OGP)・黄金比など)' +
866
+ 'からのずれを返す。1920×1080 のように名前のある寸法はその名前も返す。' +
867
+ 'round で 四捨五入(round)・偶数(even)・切り捨て(floor)・切り上げ(ceil)を選べ、' +
868
+ '丸めた場合は丸め後の実際の比率と指定した比率からのずれ(%)を返す。' +
869
+ 'H.264 / H.265 は色情報を縦横半分で持つ(YUV 4:2:0)ため幅・高さとも偶数が必要で、動画向けには round="even" を使う。' +
870
+ 'box を渡すと、その枠へ contain / cover ではめ込んだときの描画サイズ・拡大率・余白(レターボックス / ピラーボックス)・' +
871
+ '切り取られる量・見える割合を返す。' +
872
+ 'widths か table=true でブレークポイントごとの高さの早見表を、snippet=true で aspect-ratio のCSSと' +
873
+ '(CLSを防ぐ width / height 属性入りの)HTMLを返す。' +
874
+ '完全ローカル処理・ネットワーク送信なし。',
875
+ inputSchema: {
876
+ ratio: z
877
+ .union([z.string(), z.number()])
878
+ .optional()
879
+ .describe("アスペクト比('16:9' / '16/9' / '16x9' / '1.85' / 1.85。省略時は width と height の両方が必要)"),
880
+ width: z.number().optional().describe('幅 px(ratio と併せると高さを求める。ratio を省くと height と対で比率を求める)'),
881
+ height: z.number().optional().describe('高さ px(ratio と併せると幅を求める)'),
882
+ round: z
883
+ .enum(['none', 'round', 'floor', 'ceil', 'even'])
884
+ .optional()
885
+ .describe("整数への丸め方(既定 'none'=計算どおり。'even' は動画向けに偶数へ寄せる)"),
886
+ widths: z
887
+ .array(z.number())
888
+ .optional()
889
+ .describe('早見表に並べる幅の一覧(既定 [320,375,414,768,1024,1280,1440,1920]。渡すと表を返す)'),
890
+ table: z.boolean().optional().describe('既定の幅で早見表を返すか(widths を渡した場合は自動で true)'),
891
+ box: z
892
+ .union([z.string(), z.object({ width: z.number(), height: z.number() })])
893
+ .optional()
894
+ .describe("はめ込む枠の寸法('1280x400' または {width,height})"),
895
+ fit: z.enum(['cover', 'contain']).optional().describe("box へのはめ方(既定 'cover'=枠を埋めてはみ出しを切る)"),
896
+ snippet: z.boolean().optional().describe('CSS と HTML のスニペットを返すか(既定 false)'),
897
+ selector: z.string().optional().describe("スニペットのセレクタ(既定 '.media')"),
898
+ target: z
899
+ .enum(['img', 'video', 'iframe', 'background'])
900
+ .optional()
901
+ .describe("スニペットの中に入れる要素(既定 'img')"),
902
+ objectFit: z
903
+ .enum(['cover', 'contain', 'fill', 'none'])
904
+ .optional()
905
+ .describe("スニペットの object-fit(既定 'cover'。target=iframe では使わない)"),
906
+ fallback: z
907
+ .boolean()
908
+ .optional()
909
+ .describe('aspect-ratio 非対応ブラウザ向けの padding-top フォールバックを付けるか(既定 false)'),
910
+ },
911
+ },
912
+ async (opts) => {
913
+ await logUsage('aspect_ratio_calc');
914
+ return asText(aspectRatioCalc(opts));
915
+ },
916
+ );
917
+
918
+ server.registerTool(
919
+ 'markdown_table',
920
+ {
921
+ title: 'TSV/CSV → Markdownテーブル整形・相互変換',
922
+ description:
923
+ 'ExcelやスプレッドシートからコピーしたTSV/CSV(クリップボードの中身はカンマ区切りではなくタブ区切り)を' +
924
+ 'Markdownの表へ整形し、逆にMarkdownの表をCSV/TSV/HTML/JSONへ書き出す(tools.first-ch.com/markdown-table/ と同一ロジック)。' +
925
+ '区切り文字はタブ・カンマ・セミコロンのそれぞれで実際に読んでみて「列数がいちばん揃うもの」を選ぶ方式で自動判定するため、' +
926
+ '金額の桁区切り(1,200)が入っていても列がずれない。CSVはRFC 4180の引用符(セル内のカンマ・改行・"" )に対応。' +
927
+ '桁揃えでは全角文字をUnicodeのEast Asian Width(Wide / Fullwidth)に従って2桁として数えるので、等幅フォントで縦線が揃う。' +
928
+ '空でないセルがすべて数値(桁区切り・小数点・通貨記号・%・単位を含む)の列は自動で右寄せ(---:)にし、aligns で列ごとに指定もできる。' +
929
+ 'セルの中の | は \\| へエスケープし、セル内の改行は <br> か半角スペースへ置換し、列数が足りない行には空セルを補う(直した件数は notes で返す)。' +
930
+ 'Markdownを読むときは区切り行のコロンから配置を読み取り、<br> は改行へ戻すので、CSVへ書き出せばセル内改行のあるデータとして表計算ソフトへ戻せる。' +
931
+ 'text か path のどちらか一方を渡す。outputPath を渡すとファイルへ書き出す(本文は返さない)。' +
932
+ '完全ローカル処理・ネットワーク送信なし。',
933
+ inputSchema: {
934
+ text: z.string().optional().describe('対象のテキスト(TSV / CSV / セミコロン区切り / Markdownの表。path と排他)'),
935
+ path: z.string().optional().describe('対象ファイルの絶対パス(UTF-8として読む。text と排他)'),
936
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると text は返さない)'),
937
+ from: z
938
+ .enum(['auto', 'tsv', 'csv', 'ssv', 'markdown'])
939
+ .optional()
940
+ .describe("入力の形式(既定 'auto'=自動判定。ssv はセミコロン区切り)"),
941
+ to: z
942
+ .enum(['markdown', 'csv', 'tsv', 'ssv', 'html', 'json'])
943
+ .optional()
944
+ .describe("出力の形式(既定 'markdown'。json は見出しをキーにしたオブジェクトの配列)"),
945
+ header: z
946
+ .enum(['first', 'auto', 'none'])
947
+ .optional()
948
+ .describe("1行目の扱い(既定 'first'=見出し。'auto'=col1… を振る / 'none'=見出しを空欄にする)"),
949
+ align: z
950
+ .enum(['auto', 'none', 'left', 'center', 'right'])
951
+ .optional()
952
+ .describe("全列の配置(既定 'auto'=元のMarkdownの指定を引き継ぎ、数値列は右寄せ)"),
953
+ aligns: z
954
+ .array(z.enum(['none', 'left', 'center', 'right']))
955
+ .optional()
956
+ .describe('列ごとの配置(align より優先。左から順に対応させる)'),
957
+ pad: z.boolean().optional().describe('桁を揃えるか(既定 true。Markdown出力のみ。表示結果は変わらずソースが読みやすくなる)'),
958
+ eastAsian: z.boolean().optional().describe('全角を2桁として数えるか(既定 true。等幅フォントで縦線を揃えるため)'),
959
+ autoNumber: z.boolean().optional().describe('数値だけの列を右寄せにするか(既定 true)'),
960
+ trim: z.boolean().optional().describe('セルの前後の空白を削るか(既定 true)'),
961
+ skipEmpty: z.boolean().optional().describe('空行を飛ばすか(既定 true)'),
962
+ transpose: z.boolean().optional().describe('行と列を入れ替えるか(既定 false)'),
963
+ multiline: z
964
+ .enum(['br', 'space'])
965
+ .optional()
966
+ .describe("セル内の改行の書き方(既定 'br'=<br>。'space' は半角スペースへ潰す)"),
967
+ eol: z.enum(['lf', 'crlf']).optional().describe("出力の改行コード(既定 'lf')"),
968
+ },
969
+ },
970
+ async (opts) => {
971
+ await logUsage('markdown_table');
972
+ return asText(await markdownTable(opts));
973
+ },
974
+ );
975
+
976
+ server.registerTool(
977
+ 'sql_format',
978
+ {
979
+ title: 'SQLクエリの整形(予約語の大文字化・句ごとの改行・字下げ)',
980
+ description:
981
+ 'ログやORMが吐いた1行に固まったSQLを、予約語の大文字化・句ごとの改行・字下げの付いたクエリへ整形する' +
982
+ '(tools.first-ch.com/sql-format/ と同一ロジック)。' +
983
+ 'SELECT / FROM / WHERE / GROUP BY / HAVING / ORDER BY / LIMIT / INSERT INTO / VALUES / UPDATE / SET / ' +
984
+ 'DELETE FROM / WITH / UNION などの句を行頭へ、その中身を1段下げて並べ直す。JOIN は行頭に置いて ON を1段下げ、' +
985
+ 'AND / OR は条件ごとに改行する(BETWEEN a AND b の AND は条件の区切りではないので改行しない)。' +
986
+ '( の直後が SELECT / WITH / VALUES のときだけサブクエリとみなして改行+字下げし、' +
987
+ '関数呼び出し(SUM(…) / IN (1, 2, 3) / OVER (PARTITION BY … ORDER BY …))は1行のまま保つ。' +
988
+ 'CASE 式は WHEN / ELSE / END を縦に並べる。予約語と型名だけを大文字(または小文字)へ揃え、' +
989
+ 'テーブル名・列名・別名の綴りは変えない(識別子の折りたたみ方がDBごとに違うため)。' +
990
+ "文字列('…')・引用符付き識別子(\"…\" / `…` / […])・コメント(-- / # / /* … */)・" +
991
+ 'プレースホルダ(? / :name / $1 / @var)はそのまま残す。' +
992
+ '整形と同時に、WHEREの無いUPDATE/DELETE・閉じていない括弧や引用符・SELECT *・暗黙の結合・プレースホルダの有無を notes で返す。' +
993
+ 'compact=true にすると逆に改行を畳んで1行へ戻す。特定DBのパーサーではなく字句ベースの整形器なので、' +
994
+ 'MySQL・PostgreSQL・SQL Server・SQLite・Oracle の方言も壊さずに通す(構文エラーの検出はしない)。' +
995
+ 'text か path のどちらか一方を渡す。outputPath を渡すとファイルへ書き出す(本文は返さない)。' +
996
+ '完全ローカル処理・ネットワーク送信なし。',
997
+ inputSchema: {
998
+ text: z.string().optional().describe('対象のSQL(path と排他)'),
999
+ path: z.string().optional().describe('対象ファイルの絶対パス(UTF-8として読む。text と排他)'),
1000
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると text は返さない)'),
1001
+ keywordCase: z
1002
+ .enum(['upper', 'lower', 'preserve'])
1003
+ .optional()
1004
+ .describe("予約語・型名の表記(既定 'upper'。'preserve' は元の綴りのまま)"),
1005
+ functionCase: z
1006
+ .enum(['upper', 'lower', 'preserve'])
1007
+ .optional()
1008
+ .describe("関数名の表記(既定 'upper')"),
1009
+ indent: z.enum(['2', '4', '8', 'tab']).optional().describe("インデントの幅(既定 '4'=スペース4つ)"),
1010
+ commaStyle: z.enum(['trailing', 'leading']).optional().describe("カンマの位置(既定 'trailing'=行末)"),
1011
+ logicStyle: z.enum(['leading', 'trailing']).optional().describe("AND / OR の位置(既定 'leading'=行頭)"),
1012
+ breakColumns: z.boolean().optional().describe('SELECT の列・SET の代入・VALUES の行を1行ずつに分けるか(既定 true)'),
1013
+ breakLogic: z.boolean().optional().describe('WHERE / HAVING / ON の AND / OR で折り返すか(既定 true)'),
1014
+ breakOn: z.boolean().optional().describe('JOIN の ON を改行して1段下げるか(既定 true)'),
1015
+ breakCase: z.boolean().optional().describe('CASE 式の WHEN / ELSE / END を縦に並べるか(既定 true)'),
1016
+ breakSubquery: z.boolean().optional().describe('サブクエリの括弧を改行して字下げするか(既定 true)'),
1017
+ expandClauses: z.boolean().optional().describe('FROM や WHERE の中身も次の行から書くか=完全展開(既定 false)'),
1018
+ compact: z.boolean().optional().describe('改行を畳んで1行にまとめるか(既定 false)'),
1019
+ eol: z.enum(['lf', 'crlf']).optional().describe("出力の改行コード(既定 'lf')"),
1020
+ },
1021
+ },
1022
+ async (opts) => {
1023
+ await logUsage('sql_format');
1024
+ return asText(await sqlFormatTool(opts));
1025
+ },
1026
+ );
1027
+
1028
+ server.registerTool(
1029
+ 'qr_generate',
1030
+ {
1031
+ title: 'QRコードの生成(SVG / PNG / 文字の図)',
1032
+ description:
1033
+ 'URLやテキストからQRコードを生成し、SVG(ベクター)・PNG・端末に貼れる文字の図で返す' +
1034
+ '(tools.first-ch.com/qr/ と同一ロジック)。' +
1035
+ '符号化(数字 / 英数字 / UTF-8のバイトモードを入力に応じて自動選択)・リード・ソロモン符号による誤り訂正・' +
1036
+ '位置検出パターンや型番情報の配置・8種類のマスクからの自動選択まで自前で実装しており(JIS X 0510 / ISO 18004・型番1〜40)、' +
1037
+ '外部のAPIも画像生成サーバーも使わない。' +
1038
+ '誤り訂正レベルは L(約7%)/ M(約15%)/ Q(約25%)/ H(約30%)から選ぶ(印刷物はQ以上を推奨)。' +
1039
+ 'size は出力の一辺(px。SVGでは表示上の初期サイズ)、margin は余白=クワイエットゾーンのモジュール数で規格の推奨は4' +
1040
+ '(0にすると背景によっては読み取れなくなる)。' +
1041
+ 'Wi-Fi(WIFI:T:WPA;S:…;P:…;;)・メール(mailto:)・電話(tel:)・SMS(SMSTO:)・座標(geo:)などの' +
1042
+ '定型書式も、その文字列をそのまま text に渡せばよい。' +
1043
+ 'outputPath を渡すとファイルへ書き出す(本文は返さない)。format="png" で outputPath を省いた場合は data URI で返る。' +
1044
+ '容量の上限は数字7089桁・英数字4296文字・バイト2953文字(いずれもレベルL)で、超えるとエラーになる。' +
1045
+ '完全ローカル処理・ネットワーク送信なし。',
1046
+ inputSchema: {
1047
+ text: z.string().describe('QRコードにする内容(URL・テキスト。UTF-8)'),
1048
+ ecLevel: z
1049
+ .enum(['L', 'M', 'Q', 'H'])
1050
+ .optional()
1051
+ .describe("誤り訂正レベル(既定 'M'。L=約7% / M=約15% / Q=約25% / H=約30%まで復元できる)"),
1052
+ size: z.number().int().optional().describe('出力の一辺(px。64〜4096・既定 320)'),
1053
+ margin: z.number().int().optional().describe('余白のモジュール数(0〜32・既定 4=規格の推奨)'),
1054
+ format: z.enum(['svg', 'png', 'text']).optional().describe("出力の形式(既定 'svg'。'text' は端末に貼れる文字の図)"),
1055
+ mode: z
1056
+ .enum(['auto', 'numeric', 'alnum', 'byte'])
1057
+ .optional()
1058
+ .describe("符号化モード(既定 'auto'=入力に合う最も密なモードを選ぶ)"),
1059
+ mask: z.number().int().optional().describe('マスクパターン(0〜7。省略時は減点の一番低いものを自動選択)'),
1060
+ minVersion: z.number().int().optional().describe('型番の下限(1〜40。指定するとこれより小さい型番は使わない)'),
1061
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると本文は返さない)'),
1062
+ },
1063
+ },
1064
+ async (opts) => {
1065
+ await logUsage('qr_generate');
1066
+ return asText(await qrGenerateTool(opts));
1067
+ },
1068
+ );
1069
+
1070
+ server.registerTool(
1071
+ 'unixtime_convert',
1072
+ {
1073
+ title: 'UNIXタイムスタンプ⇄日時の相互変換',
1074
+ description:
1075
+ 'UNIX秒・ミリ秒・マイクロ秒・ナノ秒と、ISO 8601や日時文字列を相互に変換する' +
1076
+ '(tools.first-ch.com/unixtime/ と同一ロジック)。ログに出ている数値が結局いつなのかの確認、' +
1077
+ '期限や有効期限の突き合わせ、タイムゾーンをまたぐ時刻のすり合わせに使う。' +
1078
+ '数値の単位は桁数から自動判定する(10桁までを秒 / 13桁までをミリ秒 / 16桁までをマイクロ秒 / それ以上をナノ秒)。' +
1079
+ 'unit を渡せば自動判定を使わずその単位で読む。ミリ秒より下の桁は切り捨て、その旨を notes で返す。' +
1080
+ '日時側は 2026-08-24T09:30:00Z(ISO 8601)・2026-08-24 18:30・2026/8/24 9:05・2026年8月24日 18時30分・' +
1081
+ 'Sun, 24 Aug 2026 03:00:00 GMT(HTTP-date)・now を受け付け、' +
1082
+ 'CSVやJSONから貼ったときの引用符・角括弧・行末カンマは自動で外す。' +
1083
+ 'input は1行1件で最大500行まとめて変換でき、行ごとにUNIX秒・ミリ秒・ISO 8601(UTC)・' +
1084
+ '指定タイムゾーンの現地時刻(曜日・UTCオフセット付き)・相対表示(○分前 / ○日後)を返す。' +
1085
+ '読めなかった行は他の行を巻き込まず、その行だけ error として返す。' +
1086
+ '**オフセットを持たない日時は timeZone の壁時計として解釈**し、必ず notes で明示する' +
1087
+ '(+09:00 や Z が入力にあれば timeZone より入力側が優先される)。' +
1088
+ '夏時間で存在しない時刻は切り替え後へ繰り上げ、こちらも notes に出す。' +
1089
+ '8桁の数字(20260824)はUNIX秒として読むため、日付のつもりの入力には notes で注意を返す。' +
1090
+ '負の値(1970年より前)と小数点付きの秒にも対応する。' +
1091
+ '完全ローカル処理・ネットワーク送信なし。',
1092
+ inputSchema: {
1093
+ input: z.string().describe('変換する値(1行1件。UNIX秒/ミリ秒/マイクロ秒/ナノ秒・ISO 8601・日時文字列・now)'),
1094
+ timeZone: z
1095
+ .string()
1096
+ .optional()
1097
+ .describe("現地時刻に使うIANAタイムゾーン名(既定 'UTC'。例: Asia/Tokyo / America/New_York)"),
1098
+ unit: z
1099
+ .enum(['auto', 's', 'ms', 'us', 'ns'])
1100
+ .optional()
1101
+ .describe("数値の単位(既定 'auto'=桁数から自動判定。s=秒 / ms=ミリ秒 / us=マイクロ秒 / ns=ナノ秒)"),
1102
+ now: z
1103
+ .union([z.number(), z.string()])
1104
+ .optional()
1105
+ .describe('相対表示の基準時刻(UNIXミリ秒の数値か日時文字列。既定は実行時刻)'),
1106
+ lang: z.enum(['ja', 'en']).optional().describe("ラベル・相対表示・注記の言語(既定 'ja')"),
1107
+ },
1108
+ },
1109
+ async (opts) => {
1110
+ await logUsage('unixtime_convert');
1111
+ return asText(unixtimeConvert(opts.input, opts));
1112
+ },
1113
+ );
1114
+
175
1115
  await server.connect(new StdioServerTransport());