@first-ch/tools-mcp 0.30.0 → 0.32.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 +10 -2
- package/html-md.mjs +1226 -0
- package/package.json +17 -3
- package/server.mjs +87 -0
- package/wareki.mjs +669 -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集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N
|
|
3
|
+
"version": "0.32.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,19 @@
|
|
|
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",
|
|
183
|
+
"wareki",
|
|
184
|
+
"japanese-era",
|
|
185
|
+
"japanese-calendar",
|
|
186
|
+
"reiwa",
|
|
187
|
+
"heisei",
|
|
188
|
+
"showa",
|
|
189
|
+
"age-calculator"
|
|
178
190
|
],
|
|
179
191
|
"author": "First CH LLC (https://first-ch.com)",
|
|
180
192
|
"homepage": "https://tools.first-ch.com",
|
|
@@ -221,6 +233,8 @@
|
|
|
221
233
|
"zenkaku.mjs",
|
|
222
234
|
"cidr.mjs",
|
|
223
235
|
"date-calc.mjs",
|
|
236
|
+
"html-md.mjs",
|
|
237
|
+
"wareki.mjs",
|
|
224
238
|
"date-holidays.json",
|
|
225
239
|
"vendor/",
|
|
226
240
|
"README.md",
|
package/server.mjs
CHANGED
|
@@ -33,6 +33,8 @@ 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';
|
|
37
|
+
import { warekiConvertTool } from './wareki.mjs';
|
|
36
38
|
|
|
37
39
|
const { version } = createRequire(import.meta.url)('./package.json');
|
|
38
40
|
const server = new McpServer({ name: 'firstch-tools', version });
|
|
@@ -1429,4 +1431,89 @@ server.registerTool(
|
|
|
1429
1431
|
},
|
|
1430
1432
|
);
|
|
1431
1433
|
|
|
1434
|
+
server.registerTool(
|
|
1435
|
+
'html_to_markdown',
|
|
1436
|
+
{
|
|
1437
|
+
title: 'HTML → Markdown 変換',
|
|
1438
|
+
description:
|
|
1439
|
+
'HTML断片をMarkdownへ変換する(tools.first-ch.com/html-md/ と同一ロジック)。' +
|
|
1440
|
+
'取得したページの本文をMarkdownに直して渡す前処理、既存サイトの原稿をMarkdown管理へ移す移行作業に使う。' +
|
|
1441
|
+
'見出し(h1〜h6)・段落・改行・強調・取り消し線・リスト(入れ子・start 属性・チェックボックス)・' +
|
|
1442
|
+
'表(thead / caption と align / text-align による列の配置)・リンク・画像・コードブロック' +
|
|
1443
|
+
"(class=\"language-*\" から言語を拾う)・引用・水平線・定義リスト・figure / figcaption・details / summary に対応し、" +
|
|
1444
|
+
'script・style・hidden や display:none の要素・装飾のための div / span は自動で取り除く。' +
|
|
1445
|
+
'**HTMLの解釈にブラウザのDOMを使っていない**——字句解析も木の組み立ても自前なので、Web版と結果が一致し、' +
|
|
1446
|
+
'閉じ忘れたタグは末尾で閉じ、行き場のない閉じタグは捨てて変換を続ける' +
|
|
1447
|
+
'(**属性の引用符が閉じていない場合だけは打ち切る**。続けると残りの文書全体を1つの属性値として飲み込むため)。' +
|
|
1448
|
+
'補った内容・落とした内容はすべて notes で返す。' +
|
|
1449
|
+
'**Markdownに書けないものは黙って捨てない**: セルの結合(colspan は空セルで埋め、rowspan は先頭行にだけ値が入る)・' +
|
|
1450
|
+
'セル内のリスト/コードブロック(その表だけHTMLのまま残す)・定義リスト(Markdown Extra の ": " 記法)・' +
|
|
1451
|
+
'sup / sub / mark / iframe / svg(unknown で「HTMLのまま残す/文字だけ残す/取り除く」を選ぶ)。' +
|
|
1452
|
+
'表・タスクリスト・取り消し線はGFMの拡張でCommonMarkには無いため gfm=false で切れる。' +
|
|
1453
|
+
'**相対URLは貼り先で必ず壊れる**ので、base_url を渡すとリンクと画像を絶対URLへ直す(アンカーと絶対URLはそのまま)。' +
|
|
1454
|
+
'main_only=true は main / article の中だけを取り出して header・nav・footer・aside・form を落とす。' +
|
|
1455
|
+
'html か path のどちらか一方を渡す。outputPath を渡すとファイルへ書き出す(本文は返さない)。' +
|
|
1456
|
+
'ネットワークへは出ないので、ページの取得は呼び出し側で行うこと。完全ローカル処理・ネットワーク送信なし。',
|
|
1457
|
+
inputSchema: {
|
|
1458
|
+
html: z.string().optional().describe('変換するHTML(path と排他)'),
|
|
1459
|
+
path: z.string().optional().describe('変換するHTMLファイルの絶対パス(UTF-8として読む。html と排他)'),
|
|
1460
|
+
outputPath: z.string().optional().describe('結果を書き出す絶対パス(指定すると markdown は返さない)'),
|
|
1461
|
+
main_only: z.boolean().optional().describe('main / article の中だけを取り出し、header・nav・footer・aside・form を落とす(既定 false)'),
|
|
1462
|
+
base_url: z.string().optional().describe('相対URLを絶対URLへ直すための基準(元ページのアドレス)'),
|
|
1463
|
+
gfm: z.boolean().optional().describe('表・タスクリスト・取り消し線(GitHub Flavored Markdown。既定 true)'),
|
|
1464
|
+
escape: z.boolean().optional().describe('本文中の * _ [ ` や行頭の # - 1. をバックスラッシュで打ち消す(既定 true)'),
|
|
1465
|
+
pad_tables: z.boolean().optional().describe('表の桁を揃える(全角を2桁として数える。既定 true)'),
|
|
1466
|
+
headings: z.enum(['atx', 'setext']).optional().describe("見出しの書き方(既定 'atx' = #)"),
|
|
1467
|
+
bullet: z.enum(['-', '*', '+']).optional().describe("箇条書きの印(既定 '-')"),
|
|
1468
|
+
code_block: z.enum(['fenced', 'indented']).optional().describe("コードブロックの書き方(既定 'fenced')"),
|
|
1469
|
+
links: z.enum(['inline', 'reference', 'strip']).optional().describe("リンクの書き方(既定 'inline'。'reference' は末尾にまとめる / 'strip' は文字だけ残す)"),
|
|
1470
|
+
images: z.enum(['keep', 'alt', 'drop']).optional().describe("画像の扱い(既定 'keep' = )"),
|
|
1471
|
+
tables: z.enum(['gfm', 'html']).optional().describe("表の書き方(既定 'gfm')"),
|
|
1472
|
+
unknown: z.enum(['keep', 'text', 'drop']).optional().describe("Markdownに対応が無い要素の扱い(既定 'keep' = HTMLのまま)"),
|
|
1473
|
+
br: z.enum(['spaces', 'backslash', 'html', 'space']).optional().describe("<br> の書き方(既定 'spaces' = 行末に半角スペース2つ)"),
|
|
1474
|
+
lang: z.enum(['ja', 'en']).optional().describe("notes の言語(既定 'ja')"),
|
|
1475
|
+
},
|
|
1476
|
+
},
|
|
1477
|
+
async (opts) => {
|
|
1478
|
+
await logUsage('html_to_markdown');
|
|
1479
|
+
return asText(await htmlToMarkdownTool(opts));
|
|
1480
|
+
},
|
|
1481
|
+
);
|
|
1482
|
+
|
|
1483
|
+
server.registerTool(
|
|
1484
|
+
'wareki_convert',
|
|
1485
|
+
{
|
|
1486
|
+
title: '和暦 ⇄ 西暦変換・満年齢',
|
|
1487
|
+
description:
|
|
1488
|
+
'和暦(令和・平成・昭和・大正・明治)と西暦を相互に変換し、曜日と干支を返す(tools.first-ch.com/wareki/ と同一ロジック)。' +
|
|
1489
|
+
'契約書・請求書・行政書類の日付表記の変換と検算に使う。' +
|
|
1490
|
+
'`mode="convert"` は date(1件)か dates(配列・1000件まで)を受け、**西暦か和暦かを自動で見分ける**: ' +
|
|
1491
|
+
'2026-10-01 / 2026/10/1 / 20261001 / 2026年10月1日 / 令和8年10月1日 / R8.10.1 / 令和八年十月一日 / ㋿8.10.1 / Reiwa 8 など。' +
|
|
1492
|
+
'年だけ(1989・昭和64年)・年月だけ(2019-05)も変換でき、改元をまたぐときは両方の元号を返す。' +
|
|
1493
|
+
'書き方は和暦(元年表記・曜日つき・漢数字)・略記(R8.10.1 / R08.10.01)・西暦・ISO 8601・英語を formats で返す。' +
|
|
1494
|
+
'改元日は大正1912-07-30・昭和1926-12-25・平成1989-01-08・令和2019-05-01。' +
|
|
1495
|
+
'**存在しない和暦(平成32年・平成31年5月1日・令和元年4月30日)も西暦へ直したうえで正しい和暦を notes で指摘**し、' +
|
|
1496
|
+
'書き添えの曜日((金)など)が実際と違えば WEEKDAY_MISMATCH を返す。' +
|
|
1497
|
+
'**明治5年(1872年)以前は旧暦のため年単位でだけ換算する**(LUNAR_CALENDAR)。' +
|
|
1498
|
+
'`mode="age"` は birth(和暦可)と reference(省略時は日本時間の今日)から満年齢(誕生日に1つ増える・2月29日生まれは平年だと3月1日)・' +
|
|
1499
|
+
'年月日の内訳・数え年・次の誕生日と、小学校〜大学の入学・卒業の年(4月2日〜翌4月1日生まれが同学年・浪人なし)を返す。' +
|
|
1500
|
+
'`mode="eras"` は元号一覧を返し、from_year / to_year を渡すと和暦・干支・満年齢の早見表も返す(500年分まで)。' +
|
|
1501
|
+
'日付の書き方の誤りは ok:false と error.code で返す。日付は通算日の整数で扱うのでサーバーのタイムゾーンで1日ずれない。完全ローカル処理・ネットワーク送信なし。',
|
|
1502
|
+
inputSchema: {
|
|
1503
|
+
mode: z.enum(['convert', 'age', 'eras']).optional().describe('処理の種類(省略時は birth があれば age、date/dates があれば convert、無ければ eras)'),
|
|
1504
|
+
date: z.string().optional().describe('変換する日付1件(西暦でも和暦でも。例: 令和8年10月1日 / 2026-10-01 / R8.10.1 / 昭和60年)'),
|
|
1505
|
+
dates: z.array(z.string()).optional().describe('一括変換する日付の配列(1000件まで。date より優先)'),
|
|
1506
|
+
birth: z.string().optional().describe('mode=age の生年月日(和暦可)'),
|
|
1507
|
+
reference: z.string().optional().describe('mode=age の基準日・mode=eras の年齢の基準(省略時は日本時間の今日)'),
|
|
1508
|
+
from_year: z.number().int().optional().describe('mode=eras で早見表を作る最初の西暦年(1868〜)'),
|
|
1509
|
+
to_year: z.number().int().optional().describe('mode=eras で早見表を作る最後の西暦年(省略時は基準日の年)'),
|
|
1510
|
+
lang: z.enum(['ja', 'en']).optional().describe("曜日・干支の動物名・指摘事項の言語(既定 'ja')"),
|
|
1511
|
+
},
|
|
1512
|
+
},
|
|
1513
|
+
async (opts) => {
|
|
1514
|
+
await logUsage('wareki_convert');
|
|
1515
|
+
return asText(await warekiConvertTool(opts));
|
|
1516
|
+
},
|
|
1517
|
+
);
|
|
1518
|
+
|
|
1432
1519
|
await server.connect(new StdioServerTransport());
|