@first-ch/tools-mcp 0.30.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.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ツールとして提供するサーバー",
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"
@@ -174,7 +174,12 @@
174
174
  "date-calculator",
175
175
  "due-date",
176
176
  "payment-terms",
177
- "invoice"
177
+ "invoice",
178
+ "html-to-markdown",
179
+ "html2markdown",
180
+ "markdown-converter",
181
+ "web-scraping",
182
+ "content-migration"
178
183
  ],
179
184
  "author": "First CH LLC (https://first-ch.com)",
180
185
  "homepage": "https://tools.first-ch.com",
@@ -221,6 +226,7 @@
221
226
  "zenkaku.mjs",
222
227
  "cidr.mjs",
223
228
  "date-calc.mjs",
229
+ "html-md.mjs",
224
230
  "date-holidays.json",
225
231
  "vendor/",
226
232
  "README.md",
package/server.mjs CHANGED
@@ -33,6 +33,7 @@ import { zenkakuConvertTool } from './zenkaku.mjs';
33
33
  import { csvConvertTool } from './csv-json.mjs';
34
34
  import { cidrCalcTool } from './cidr.mjs';
35
35
  import { dateCalcTool } from './date-calc.mjs';
36
+ import { htmlToMarkdownTool } from './html-md.mjs';
36
37
 
37
38
  const { version } = createRequire(import.meta.url)('./package.json');
38
39
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -1429,4 +1430,53 @@ server.registerTool(
1429
1430
  },
1430
1431
  );
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
+
1432
1482
  await server.connect(new StdioServerTransport());