@first-ch/tools-mcp 0.25.0 → 0.27.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.25.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クローラーの許可プリセット付き))をMCPツールとして提供するサーバー",
3
+ "version": "0.27.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ツールとして提供するサーバー",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"
@@ -141,7 +141,14 @@
141
141
  "gptbot",
142
142
  "claudebot",
143
143
  "ai-crawler",
144
- "web-crawler"
144
+ "web-crawler",
145
+ "case-converter",
146
+ "camelcase",
147
+ "snake-case",
148
+ "kebab-case",
149
+ "pascalcase",
150
+ "identifier",
151
+ "rename"
145
152
  ],
146
153
  "author": "First CH LLC (https://first-ch.com)",
147
154
  "homepage": "https://tools.first-ch.com",
@@ -183,6 +190,8 @@
183
190
  "qr.mjs",
184
191
  "unixtime.mjs",
185
192
  "robots-txt.mjs",
193
+ "case-convert.mjs",
194
+ "csv-json.mjs",
186
195
  "vendor/",
187
196
  "README.md",
188
197
  "LICENSE"
package/server.mjs CHANGED
@@ -28,6 +28,8 @@ import { sqlFormatTool } from './sql-format.mjs';
28
28
  import { qrGenerateTool } from './qr.mjs';
29
29
  import { unixtimeConvert } from './unixtime.mjs';
30
30
  import { robotsTxtGenerate } from './robots-txt.mjs';
31
+ import { caseConvertTool } from './case-convert.mjs';
32
+ import { csvConvertTool } from './csv-json.mjs';
31
33
 
32
34
  const { version } = createRequire(import.meta.url)('./package.json');
33
35
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -1195,4 +1197,98 @@ server.registerTool(
1195
1197
  },
1196
1198
  );
1197
1199
 
1200
+ server.registerTool(
1201
+ 'case_convert',
1202
+ {
1203
+ title: '文字列のケース変換(camelCase / snake_case / kebab-case)',
1204
+ description:
1205
+ '識別子を camelCase / PascalCase / snake_case / CONSTANT_CASE / kebab-case と、Train-Case・dot.case・' +
1206
+ 'Title Case・Sentence case・lower case・UPPER CASE を合わせた11形式へ相互変換する' +
1207
+ '(tools.first-ch.com/case/ と同一ロジック)。変数名の一括リネーム、DBの列名とAPIのJSONキーの読み替え、' +
1208
+ 'CSVヘッダーの整形といった定型処理に使う。' +
1209
+ 'scope で処理の単位を選ぶ: lines(既定=1行1件) / items(行内のカンマ・タブ区切りで1件ずつ=CSVヘッダー) / whole(全体で1件)。' +
1210
+ '**前後の空白・インデント・改行コード(LF/CRLF)・区切り記号はそのまま残す**ので、表の列やコードの並びを崩さずに名前だけ置き換わる。' +
1211
+ '語の分かち書きは、大文字の連なりの直後に「大文字+小文字」が続くときだけ手前で切る(XMLHttpRequest → XML / Http / Request)。' +
1212
+ '数字は既定で直前の語に付ける(sha256Hash → sha256 / Hash。splitDigits=true で sha / 256 / Hash)。' +
1213
+ '頭字語は既定で畳んで parseXmlData にし、keepAcronyms=true なら parseXMLData のまま残す' +
1214
+ '(camelCase の先頭語はどちらでも小文字=URLParser → urlParser)。' +
1215
+ '大文字小文字を持たない文字(日本語など)はそのまま出力し、ローマ字化はしない。' +
1216
+ '**変換後に同じ名前へ衝突する項目**(first name と first_name はどちらも first_name)・数字で始まって識別子にできない結果・' +
1217
+ '頭字語を含む項目・入力の形式の推定を notes と stats で返す。' +
1218
+ 'allFormats=true で各項目を全形式へ展開、listFormats=true で変換せず形式の一覧と使いどころだけを返す。' +
1219
+ 'outputPath を渡すとそのパスへ書き出す。完全ローカル処理・ネットワーク送信なし。',
1220
+ inputSchema: {
1221
+ text: z.string().optional().describe('変換するテキスト(path と排他。複数行可)'),
1222
+ path: z.string().optional().describe('変換するファイルの絶対パス(UTF-8として読む。text と排他)'),
1223
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると本文は返さない)'),
1224
+ format: z
1225
+ .enum(['camel', 'pascal', 'snake', 'constant', 'kebab', 'train', 'dot', 'title', 'sentence', 'lower', 'upper'])
1226
+ .optional()
1227
+ .describe("変換先の形式(既定 'camel')"),
1228
+ scope: z
1229
+ .enum(['lines', 'items', 'whole'])
1230
+ .optional()
1231
+ .describe("処理の単位(既定 'lines'=1行1件 / 'items'=行内のカンマ・タブ区切り / 'whole'=全体で1件)"),
1232
+ splitDigits: z.boolean().optional().describe('数字の前で語を区切る(既定 false=sha256 は1語)'),
1233
+ keepAcronyms: z.boolean().optional().describe('頭字語を大文字のまま残す(既定 false=Id / Url / Xml へ畳む)'),
1234
+ allFormats: z.boolean().optional().describe('各項目を11形式すべてへ展開して返す(先頭20件まで)'),
1235
+ listFormats: z.boolean().optional().describe('変換せず、形式の一覧(名前・例・使いどころ)だけを返す'),
1236
+ lang: z.enum(['ja', 'en']).optional().describe("指摘事項の言語(既定 'ja')"),
1237
+ },
1238
+ },
1239
+ async (opts) => {
1240
+ await logUsage('case_convert');
1241
+ return asText(await caseConvertTool(opts));
1242
+ },
1243
+ );
1244
+
1245
+ server.registerTool(
1246
+ 'csv_convert',
1247
+ {
1248
+ title: 'CSV/TSV ⇄ JSON の相互変換',
1249
+ description:
1250
+ 'CSV/TSVとJSON配列を相互変換する(tools.first-ch.com/csv-json/ と同一ロジック)。' +
1251
+ '表計算ソフトから書き出した表をAPIに渡せるJSONにする、逆にAPIの応答をExcelで開ける表にする、といった用途に使う。' +
1252
+ 'direction を省くと入力の先頭が [ か { なら json2csv、そうでなければ csv2json と推定する。' +
1253
+ '区切り文字は先頭20行で「どの記号が各行に同じ個数だけ現れるか」を見て自動判定し、delimiter で固定もできる。' +
1254
+ '**stock.qty のような列名は入れ子のオブジェクトとして読み書きし、tags.0 / tags.1(tags[0] も同義)は配列になる**。' +
1255
+ '逆向きも同じ規則で平らにするので、CSVへ出してJSONへ戻すと元の構造に復元される(nest=false なら入れ子はJSONの文字列としてセル1つに入る)。' +
1256
+ '**型の読み替えは「一度数値にして文字列へ戻したとき元の表記と1文字も違わないか」で決める**ため、' +
1257
+ '0123・+1・1.50・2の53乗を超えるID(12345678901234567890)は文字列のまま残り、郵便番号・電話番号・伝票番号・バージョン番号が壊れない。' +
1258
+ '読み取りは RFC 4180 準拠で、引用符・"" エスケープ・セル内改行・CRLF・BOM に対応する(書き出し側は bom / newline を選べる)。' +
1259
+ 'JSONは配列・単体のオブジェクト・{"data":[…]} のように配列を包んだもの・1行1件のJSON Lines を受け取れる。' +
1260
+ '**JSONの構文エラーは行・桁と前後の抜粋を返す**(例外にせず ok:false の結果として返すので、そのまま直しどころになる)。' +
1261
+ 'あわせて、列数が見出しと合わない行・重複した列名(name_2 として残す)・空の見出し(column4 を割り当てる)・桁落ちする数値・' +
1262
+ '= + - @ で始まり表計算ソフトが数式として実行しうるセル(CSVインジェクション)・キーの並びが揃わないオブジェクトを notes で指摘する。' +
1263
+ 'outputPath を渡すとそのパスへ書き出す(本文は返さない)。完全ローカル処理・ネットワーク送信なし。',
1264
+ inputSchema: {
1265
+ text: z.string().optional().describe('変換する入力(CSV/TSV か JSON。path と排他)'),
1266
+ path: z.string().optional().describe('変換するファイルの絶対パス(UTF-8として読む。text と排他)'),
1267
+ outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると本文は返さない)'),
1268
+ direction: z
1269
+ .enum(['auto', 'csv2json', 'json2csv'])
1270
+ .optional()
1271
+ .describe("変換の向き(既定 'auto'=入力の先頭が [ か { なら json2csv)"),
1272
+ delimiter: z
1273
+ .enum(['auto', 'comma', 'tab', 'semicolon', 'pipe'])
1274
+ .optional()
1275
+ .describe("区切り文字(既定 'auto'。json2csv では auto はカンマ)"),
1276
+ header: z.boolean().optional().describe('1行目を見出しとして扱う/書き出す(既定 true。false なら各行は配列になる)'),
1277
+ nest: z.boolean().optional().describe('a.b 列 ⇄ 入れ子オブジェクトを相互展開する(既定 true)'),
1278
+ types: z.boolean().optional().describe('数値・true/false/null を読み替える(既定 true・csv2json のみ)'),
1279
+ trim: z.boolean().optional().describe('セル前後の空白を落とす(既定 true・csv2json のみ)'),
1280
+ emptyNull: z.boolean().optional().describe('空のセルを null にする(既定 false=空文字列・csv2json のみ)'),
1281
+ indent: z.union([z.number().int().min(0).max(8), z.literal('tab')]).optional().describe('JSONのインデント(既定 2・csv2json のみ)'),
1282
+ newline: z.enum(['lf', 'crlf']).optional().describe("改行コード(既定 'lf'・json2csv のみ)"),
1283
+ quoteAll: z.boolean().optional().describe('すべてのセルを引用符で囲む(既定 false・json2csv のみ)'),
1284
+ bom: z.boolean().optional().describe('先頭にBOMを付ける(既定 false。ExcelでUTF-8のCSVを開くとき・json2csv のみ)'),
1285
+ lang: z.enum(['ja', 'en']).optional().describe("指摘事項とエラーの言語(既定 'ja')"),
1286
+ },
1287
+ },
1288
+ async (opts) => {
1289
+ await logUsage('csv_convert');
1290
+ return asText(await csvConvertTool(opts));
1291
+ },
1292
+ );
1293
+
1198
1294
  await server.connect(new StdioServerTransport());