@first-ch/tools-mcp 0.54.0 → 0.55.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 +2 -0
- package/email-read-aloud.mjs +254 -0
- package/package.json +5 -2
- package/server.mjs +25 -0
package/README.md
CHANGED
|
@@ -94,6 +94,7 @@ This server is also registered in the [MCP Registry](https://registry.modelconte
|
|
|
94
94
|
| `reply_check` | Checks an AI-drafted reply against the email it answers before you send it (same logic as tools.first-ch.com/okurumae/). From `reply` it picks up **dates, weekdays, times, amounts, quantities (guests, nights, %), phone numbers, emails, URLs, names** (〇〇様, Dear Ms. …) and other numbers; those found in neither `received` nor your optional `facts` (hours, prices, dates) are `red` (`missing`), matches are `green` with the matching spots in `hits`, and leftover placeholders (`[Customer 1]`, 〇〇, XX, 【】, `{name}`) are `yellow`. A weekday that does not fit the date (e.g. Friday, November 8 in 2026) or a date that does not exist is `red` too (`weekday` / `nodate`, with the actual weekday). Dates without a year are checked in the year that falls between 60 days before and 305 days after `today`. Full-/half-width forms, commas, 18時30分 vs 18:30 and 3千円 vs 3,000円 are aligned for matching only — the text is never rewritten, and `start`/`end`/`line`/`column` point into `reply` as written. `count` covers every item; `items` stops at 500 (`truncated`). A `note` always says that 0 red does not mean the reply is correct. No auto-fix, no tone editing. Up to 20,000 characters per field | `reply`, `received?`, `facts?`, `today?` (YYYY-MM-DD), `includeGreen?` (default true), `lang?` (`ja` default / `en`) |
|
|
95
95
|
| `comfy_png_leak_scan` | Checks a ComfyUI PNG you received or posted for **API key formats** (Google `AIza`, OpenAI-style `sk-`, Anthropic `sk-ant-`, Hugging Face `hf_`, Replicate `r8_`) in its embedded data (same logic as tools.first-ch.com/en/comfy-key-leak/). Chunks are read in order with CRC checks; tEXt and uncompressed iTXt are searched. `status` is `found`, `none` (not a claim that the image is safe), `unchecked` (zTXt, compressed iTXt, eXIf, caBX, unknown chunks, data after IEND, over 30 MB) or `failed` (CRC mismatch, truncated, not a PNG). Each finding gives the place — node ID, `classType` and `input` from prompt, or node ID and `widgetIndex` when only a workflow exists (`fieldUnknown`) — plus flags for duplicate JSON keys, items outside inputs and bypassed/muted nodes. Node titles are not used. **Values are never returned**: only `masked` (first 4 characters) and `length`. `notice` is a heads-up message for the key owner (no values or file name; states that validity and cause were not checked) and `revoke` lists the official pages to disable each key type. With `outPath` it writes a copy without tEXt/iTXt/zTXt after re-reading it (0 text chunks, kept chunks byte-identical); the original is never changed, caBX (C2PA) PNGs are not rewritten. It does not test keys or fetch URLs, and sends nothing itself. Prefer `path`: with `base64` the image bytes (including any raw key) go into the AI conversation and to the model provider, and the result carries an `inputNote` saying so | `path` (absolute) or `base64`, `outPath?`, `overwrite?`, `includeUrl?`, `lang?` |
|
|
96
96
|
| `ai_vs_search` | Compares visitors from AI with visitors from search in **your own GA4 data** (same logic as tools.first-ch.com/en/ai-vs-search/). Pass the CSV exported from Traffic acquisition (Session default channel group, no comparison or filter) as `csv` text or an absolute `path`; Japanese and English column names are read. Returns, for Google's `AI Assistant` and `Organic Search` rows and the total of all other channels, sessions, engagement rate (engaged sessions ÷ sessions), average engagement time per session (session-weighted) and key event rate (key events ÷ sessions — not GA4's Session key event rate), plus `ratios` (AI ÷ search; `null` under 30 AI sessions), `totals.basis` (`matched` with the grand total row / `read` when rows were skipped or totals differ / `noTotal`), `excluded` line numbers, `notes` (e.g. the period includes dates before 2026-05-13, when the AI Assistant channel was added) and a `summary` to paste. No outside study figures, own AI-service list or GA4 API. Local only, nothing is sent. |
|
|
97
|
+
| `email_read_aloud` | For choosing a new email address you will repeat on the phone (same logic as tools.first-ch.com/en/mail-yomiage/). Pass up to five addresses or bare domains as `candidates`; for each it returns the read-aloud text (letters and digits one by one; `@` at, `.` dot, `-` hyphen, `_` underscore, `+` plus; only a final `.com`/`.net` read as a word) and its length in `units` (katakana morae with `lang: "ja"`, syllables with `"en"`), sorted shortest first (not a ranking). `facts` counts characters, symbols by kind (`@` excluded), repeated characters, digits and letter/digit switches. `chars` gives each character's reading, its phonetic-alphabet word from Japan's Radio Station Operation Rules Appended Table 5 (the same words as the ITU table) and a Japanese example word. Unreadable candidates come back with `ok: false` and an error code. `card` is a comparison line with the addresses masked. No ranking, look-alike checks, availability or existence checks. Fully local. |
|
|
97
98
|
|
|
98
99
|
### App tools (`app_*`, sent to apps.first-ch.com)
|
|
99
100
|
|
|
@@ -289,6 +290,7 @@ claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp
|
|
|
289
290
|
| `reply_check` | 届いたメール(`received`)と任意の「自分で決めた事実」(`facts`:営業時間・料金・日程など)を、AI が書いた返信案(`reply`)と照らし合わせる(tools.first-ch.com/okurumae/ と同一ロジック)。返信案の**日付・曜日・時刻・金額・数量(〇名・〇泊・%)・電話番号・メールアドレス・URL・宛名(〇〇様・Dear Ms. …)・番号**のうち、原文のどちらにも無いものを `red`(`missing`)、あるものを `green`(一致した箇所は `hits`)、`[お客様1]`・〇〇・XX・【】・`{name}` などの消し忘れを `yellow` で返す。日付と曜日の食い違い(例: 2026年の11月8日(金))と存在しない日付も `red`(`weekday` / `nodate`・実際の曜日つき)。年の無い日付は `today` の60日前〜305日後に入る年で確かめる。全角/半角・カンマ・「18時30分」と「18:30」・「3千円」と「3,000円」は照合のときだけそろえ、本文は書き換えない(`start`/`end`/`line`/`column` は元の返信案の位置)。`count` は全件、`items` は500件まで(`truncated`)。「赤が0件でも内容の正しさは保証しない」注意(`note`)を常に付ける。自動修正・文体の添削はしない。各欄2万字まで | `reply`、`received?`、`facts?`、`today?`(YYYY-MM-DD)、`includeGreen?`(既定 true)、`lang?`(既定 `ja` / `en`) |
|
|
290
291
|
| `comfy_png_leak_scan` | 受け取った・投稿した ComfyUI の PNG の埋め込みデータから **APIキーの形**(Google の `AIza`・OpenAI などの `sk-`・Anthropic の `sk-ant-`・Hugging Face の `hf_`・Replicate の `r8_`)を探す(tools.first-ch.com/comfy-key-leak/ と同一ロジック)。チャンクを順に読んで CRC を確かめ、tEXt と非圧縮の iTXt を調べる。`status` は `found`・`none`(安全という意味ではない)・`unchecked`(zTXt・圧縮 iTXt・eXIf・caBX・不明なチャンク・IEND の後ろ・30MB超)・`failed`(CRC 不一致・途中で切れた・PNG でない)。場所は prompt ならノードID・`classType`・`input`、workflow だけならノードIDと `widgetIndex`(`fieldUnknown`)で、JSON の重複キー・inputs の外の項目・迂回/無効のノードの印つき。ノードの表示名は使わない。**値は返さない**(`masked`=先頭4字と `length` だけ)。`notice` はキーの持ち主へのお知らせ文(値・ファイル名なし、有効性と原因は確認していないと書く)、`revoke` は種類ごとの公式の無効化画面。`outPath` で tEXt・iTXt・zTXt を抜いたコピーを、読み直して確かめてから書く(元は変えない・caBX 付きは書き換えない)。キーの有効性の確認・URL の取得はしない(ツール自体は何も送らない)。入力は `path` を優先する: `base64` だと画像のバイト列(生のキーを含む)が AI との会話に載りモデルの提供元へ渡るため、返り値の `inputNote` でそれを伝える | `path`(絶対パス)か `base64`、`outPath?`、`overwrite?`、`includeUrl?`、`lang?` |
|
|
291
292
|
| `ai_vs_search` | **自分のサイトの GA4** で、AI から来た人と検索から来た人を比べる(tools.first-ch.com/ai-vs-search/ と同一ロジック)。[トラフィック獲得](セッションのデフォルト チャネル グループ・比較とフィルタなし)から書き出した CSV を `csv`(文字列)か `path`(絶対パス)で渡す。列名は日本語・英語とも読む。Google が分類した `AI Assistant`・`Organic Search` とそれ以外の合計について、セッション・エンゲージメント率(エンゲージのあったセッション÷セッション)・セッションあたりの平均エンゲージメント時間(セッションで重み付け)・キーイベント率(キーイベント÷セッション。GA4 の「セッションのキーイベント率」とは別)を返し、`ratios`(AI ÷ 検索。AI が30セッション未満なら `null`)、`totals.basis`(総計行と一致 `matched`/除外・ずれありの `read`/総計行なし `noTotal`)、除外した行番号 `excluded`、`notes`(2026-05-13=AI Assistant チャネルの追加日より前を含む期間など)、貼り付け用の `summary` を返す。外部の調査値・独自の AI サービス一覧・GA4 API は使わない。完全ローカル処理・送信なし。 |
|
|
293
|
+
| `email_read_aloud` | 電話や名刺で言い続けるメールアドレスを候補から決めるとき向け(tools.first-ch.com/mail-yomiage/ と同一ロジック)。`candidates` にアドレスかドメインを最大5件渡すと、候補ごとの読み上げ文(英字・数字は1字ずつ、`@` アットマーク・`.` ドット・`-` ハイフン・`_` アンダーバー・`+` プラス、末尾の `.com`・`.net` だけ語で読む)と長さ `units`(`lang: "ja"` はカタカナの拍・`"en"` は音節)を短い順に返す(順位ではない)。`facts` は文字数・記号の種類(`@` は数えない)・同じ文字の連続・数字の桁数・英字と数字の切り替わり回数。`chars` は1文字ずつの読み・欧文通話表の語(無線局運用規則 別表第五号・ITU と同じ語)・日本語の言い換え例。読めない候補は `ok: false` とエラーコード。`card` はアドレスを伏せ字にした比べの文。順位・見た目の似た文字・空き・実在の確認はしない。完全ローカル。 |
|
|
292
294
|
|
|
293
295
|
#### apps のツール(`app_*`・apps.first-ch.com へ送信)
|
|
294
296
|
|
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
/* メールアドレス候補の読み上げの長さ比べ(email_read_aloud)
|
|
2
|
+
* 読み・拍数・事実のコアは FirstCHTools の site/mail-yomiage/lib.mjs と同一
|
|
3
|
+
* (2箇所ルール: site側が正本・片方を直したらもう片方も同じ内容で反映する)。
|
|
4
|
+
* 両ファイルの「ここからコア」〜「ここまでコア」はバイト一致する(どちらも ES module):
|
|
5
|
+
* diff <(sed -n '/^\/\/ ===== ここから/,/^\/\/ ===== ここまで/p' site/mail-yomiage/lib.mjs) <(sed -n '/^\/\/ ===== ここから/,/^\/\/ ===== ここまで/p' email-read-aloud.mjs)
|
|
6
|
+
*
|
|
7
|
+
* メールアドレスかドメインの候補(最大5件)ごとに、電話で言うときの読み上げ文と長さ(ja=カタカナの拍・en=音節)、
|
|
8
|
+
* 数えられる事実(文字数・記号の種類・同じ文字の連続・数字の桁数・英字と数字の切り替わり)と1文字ずつの表を返す。
|
|
9
|
+
* 言い換えは無線局運用規則 別表第五号の欧文通話表(ITU 無線通信規則 付録14 と同じ語)。
|
|
10
|
+
* 伝わりやすさの順位・おすすめ・見た目の似た文字の判定・実在確認はしない。完全ローカル処理・ネットワーク送信なし。 */
|
|
11
|
+
|
|
12
|
+
// ===== ここからコア =====
|
|
13
|
+
export const MAX_CANDIDATES = 5;
|
|
14
|
+
export const MAX_LENGTH = 254;
|
|
15
|
+
|
|
16
|
+
// 無線局運用規則 別表第五号「通話表」2 欧文通話表(ITU 無線通信規則 付録14 と同じ語)。
|
|
17
|
+
// word=使用する語、pron=同表の英語式の発音の表示、kana=画面に添えるカタカナ(表には無い・このページの表記)
|
|
18
|
+
export const PHONETIC = {
|
|
19
|
+
a: ['Alfa', 'ALFAH', 'アルファ'], b: ['Bravo', 'BRAHVOH', 'ブラボー'], c: ['Charlie', 'CHARLEE', 'チャーリー'],
|
|
20
|
+
d: ['Delta', 'DELLTAH', 'デルタ'], e: ['Echo', 'ECKOH', 'エコー'], f: ['Foxtrot', 'FOKSTROT', 'フォックストロット'],
|
|
21
|
+
g: ['Golf', 'GOLF', 'ゴルフ'], h: ['Hotel', 'HOHTELL', 'ホテル'], i: ['India', 'INDEEAH', 'インディア'],
|
|
22
|
+
j: ['Juliett', 'JEWLEEETT', 'ジュリエット'], k: ['Kilo', 'KEYLOH', 'キロ'], l: ['Lima', 'LEEMAH', 'リマ'],
|
|
23
|
+
m: ['Mike', 'MIKE', 'マイク'], n: ['November', 'NOVEMBER', 'ノベンバー'], o: ['Oscar', 'OSSCAH', 'オスカー'],
|
|
24
|
+
p: ['Papa', 'PAHPAH', 'パパ'], q: ['Quebec', 'KEHBECK', 'ケベック'], r: ['Romeo', 'ROWMEOH', 'ロメオ'],
|
|
25
|
+
s: ['Sierra', 'SEEAIRRAH', 'シエラ'], t: ['Tango', 'TANGGO', 'タンゴ'], u: ['Uniform', 'YOUNEEFORM', 'ユニフォーム'],
|
|
26
|
+
v: ['Victor', 'VIKTAH', 'ビクター'], w: ['Whiskey', 'WISSKEY', 'ウィスキー'], x: ['X-ray', 'ECKSRAY', 'エックスレイ'],
|
|
27
|
+
y: ['Yankee', 'YANGKEY', 'ヤンキー'], z: ['Zulu', 'ZOOLOO', 'ズールー'],
|
|
28
|
+
};
|
|
29
|
+
// 同表(2)数字。ja は国内通信の語、en は航空移動業務の語と発音
|
|
30
|
+
export const PHONETIC_DIGIT = {
|
|
31
|
+
ja: ['数字のまる', '数字のひと', '数字のに', '数字のさん', '数字のよん', '数字のご', '数字のろく', '数字のなな', '数字のはち', '数字のきゅう'],
|
|
32
|
+
en: [['ZERO', 'ZE-RO'], ['ONE', 'WUN'], ['TWO', 'TOO'], ['THREE', 'TREE'], ['FOUR', 'FOW-er'],
|
|
33
|
+
['FIVE', 'FIFE'], ['SIX', 'SIX'], ['SEVEN', 'SEV-en'], ['EIGHT', 'AIT'], ['NINE', 'NIN-er']],
|
|
34
|
+
};
|
|
35
|
+
// 日本語の言い換え例(通話表ではない。利用者が選んだときだけ出す)
|
|
36
|
+
export const ALT_JA = {
|
|
37
|
+
a: 'アップル', b: 'ブック', c: 'キャット', d: 'ドッグ', e: 'エッグ', f: 'フラワー', g: 'ゴルフ', h: 'ホテル', i: 'インク',
|
|
38
|
+
j: 'ジャパン', k: 'キング', l: 'レモン', m: 'マウス', n: 'ノート', o: 'オレンジ', p: 'ペン', q: 'クイーン', r: 'ラジオ',
|
|
39
|
+
s: 'スター', t: 'トマト', u: 'ユニフォーム', v: 'ビクトリー', w: 'ワイン', x: 'エックスレイ', y: 'イエロー', z: 'ゼブラ',
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
// 1文字の読み。ja は拍(カタカナの数から小書きのャュョァィゥェォを除く)、en は音節を数える
|
|
43
|
+
const LETTER_JA = {
|
|
44
|
+
a: 'エー', b: 'ビー', c: 'シー', d: 'ディー', e: 'イー', f: 'エフ', g: 'ジー', h: 'エイチ', i: 'アイ', j: 'ジェー',
|
|
45
|
+
k: 'ケー', l: 'エル', m: 'エム', n: 'エヌ', o: 'オー', p: 'ピー', q: 'キュー', r: 'アール', s: 'エス', t: 'ティー',
|
|
46
|
+
u: 'ユー', v: 'ブイ', w: 'ダブリュー', x: 'エックス', y: 'ワイ', z: 'ゼット',
|
|
47
|
+
};
|
|
48
|
+
const DIGIT_JA = ['ゼロ', 'イチ', 'ニー', 'サン', 'ヨン', 'ゴー', 'ロク', 'ナナ', 'ハチ', 'キュー'];
|
|
49
|
+
const DIGIT_EN = [['zero', 2], ['one', 1], ['two', 1], ['three', 1], ['four', 1], ['five', 1], ['six', 1], ['seven', 2], ['eight', 1], ['nine', 1]];
|
|
50
|
+
export const SYMBOLS = {
|
|
51
|
+
'@': { key: 'at', ja: 'アットマーク', en: ['at', 1] },
|
|
52
|
+
'.': { key: 'dot', ja: 'ドット', en: ['dot', 1] },
|
|
53
|
+
'-': { key: 'hyphen', ja: 'ハイフン', en: ['hyphen', 2] },
|
|
54
|
+
'_': { key: 'underscore', ja: 'アンダーバー', en: ['underscore', 3] },
|
|
55
|
+
'+': { key: 'plus', ja: 'プラス', en: ['plus', 1] },
|
|
56
|
+
};
|
|
57
|
+
// 末尾(最後のドットの後ろ)がこの綴りのときだけ、1字ずつではなく語として読む
|
|
58
|
+
const WORDS = { com: { ja: 'コム', en: ['com', 1] }, net: { ja: 'ネット', en: ['net', 1] } };
|
|
59
|
+
const SYMBOL_ALT_JA = { '@': 'アットマーク(@)', '.': 'ドット(点)', '-': 'ハイフン(横棒)', '_': 'アンダーバー(下線)', '+': 'プラス(足す)' };
|
|
60
|
+
|
|
61
|
+
export class EmailReadAloudError extends Error {
|
|
62
|
+
constructor(code, message) { super(message); this.name = 'EmailReadAloudError'; this.code = code; }
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** カタカナの拍の数(小書きのャュョァィゥェォヮは前の字と1拍。ッ・ン・ーは1拍) */
|
|
66
|
+
export function countMora(kana) {
|
|
67
|
+
let n = 0;
|
|
68
|
+
for (const ch of String(kana)) {
|
|
69
|
+
if (/[ァ-ヶー]/.test(ch) && !/[ャュョァィゥェォヮ]/.test(ch)) n++;
|
|
70
|
+
}
|
|
71
|
+
return n;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
function readChar(ch, lang) {
|
|
75
|
+
if (/[a-z]/.test(ch)) {
|
|
76
|
+
return lang === 'en' ? { reading: ch.toUpperCase(), units: ch === 'w' ? 3 : 1 } : { reading: LETTER_JA[ch], units: countMora(LETTER_JA[ch]) };
|
|
77
|
+
}
|
|
78
|
+
if (/[0-9]/.test(ch)) {
|
|
79
|
+
const d = Number(ch);
|
|
80
|
+
return lang === 'en' ? { reading: DIGIT_EN[d][0], units: DIGIT_EN[d][1] } : { reading: DIGIT_JA[d], units: countMora(DIGIT_JA[d]) };
|
|
81
|
+
}
|
|
82
|
+
const s = SYMBOLS[ch];
|
|
83
|
+
return lang === 'en' ? { reading: s.en[0], units: s.en[1] } : { reading: s.ja, units: countMora(s.ja) };
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** 1文字ずつの表の1行(文字・読み・通話表の語・日本語の言い換え例) */
|
|
87
|
+
function charRow(ch, lang) {
|
|
88
|
+
const r = readChar(ch, lang);
|
|
89
|
+
const row = { ch, reading: r.reading, units: r.units, phonetic: null, alt: null };
|
|
90
|
+
if (/[a-z]/.test(ch)) {
|
|
91
|
+
const p = PHONETIC[ch];
|
|
92
|
+
row.phonetic = { word: p[0], pron: p[1], kana: p[2] };
|
|
93
|
+
row.alt = ALT_JA[ch] + 'の' + ch.toUpperCase();
|
|
94
|
+
} else if (/[0-9]/.test(ch)) {
|
|
95
|
+
const d = Number(ch);
|
|
96
|
+
row.phonetic = lang === 'en' ? { word: PHONETIC_DIGIT.en[d][0], pron: PHONETIC_DIGIT.en[d][1] } : { word: PHONETIC_DIGIT.ja[d] };
|
|
97
|
+
} else {
|
|
98
|
+
row.alt = SYMBOL_ALT_JA[ch];
|
|
99
|
+
}
|
|
100
|
+
return row;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** 入力の1行をそろえる(全角→半角の NFKC・小文字・前後の空白と mailto: を外す) */
|
|
104
|
+
export function normalize(line) {
|
|
105
|
+
return String(line == null ? '' : line).normalize('NFKC').trim().replace(/^mailto:/i, '').toLowerCase();
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** 複数行の文字列か配列から候補を取り出す(空行は飛ばす・最大5件) */
|
|
109
|
+
export function splitCandidates(input) {
|
|
110
|
+
const lines = Array.isArray(input) ? input.map(String) : String(input == null ? '' : input).split(/\r\n|\r|\n/);
|
|
111
|
+
const all = lines.map((s) => s.trim()).filter((s) => s !== '');
|
|
112
|
+
return { list: all.slice(0, MAX_CANDIDATES), dropped: Math.max(0, all.length - MAX_CANDIDATES) };
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** 1件を読む。ok=false のときは error(code と chars)だけを返す */
|
|
116
|
+
export function analyzeOne(raw, lang = 'ja') {
|
|
117
|
+
const text = normalize(raw);
|
|
118
|
+
const out = { input: String(raw).trim(), text, ok: false };
|
|
119
|
+
if ([...text].length > MAX_LENGTH) { out.error = { code: 'TOO_LONG' }; return out; }
|
|
120
|
+
const bad = [...new Set([...text].filter((ch) => !/[a-z0-9]/.test(ch) && !SYMBOLS[ch]))];
|
|
121
|
+
if (bad.length) { out.error = { code: 'BAD_CHAR', chars: bad }; return out; }
|
|
122
|
+
const ats = (text.match(/@/g) || []).length;
|
|
123
|
+
if (ats > 1) { out.error = { code: 'MULTI_AT' }; return out; }
|
|
124
|
+
const [local, domain] = ats ? text.split('@') : ['', text];
|
|
125
|
+
if ((ats && !local) || !domain) { out.error = { code: 'EMPTY_PART' }; return out; }
|
|
126
|
+
out.ok = true;
|
|
127
|
+
out.kind = ats ? 'email' : 'domain';
|
|
128
|
+
|
|
129
|
+
// 語として読む末尾(.com・.net)の位置
|
|
130
|
+
const lastDot = text.lastIndexOf('.');
|
|
131
|
+
const tail = lastDot >= 0 ? text.slice(lastDot + 1) : '';
|
|
132
|
+
const wordAt = lastDot >= 0 && lastDot > text.indexOf('@') && WORDS[tail] ? lastDot + 1 : -1;
|
|
133
|
+
|
|
134
|
+
const arr = [...text];
|
|
135
|
+
const chars = arr.map((ch) => charRow(ch, lang));
|
|
136
|
+
const parts = []; // 読み上げ文の部品(run=英数字の並び・sym=記号・word=語として読む末尾)
|
|
137
|
+
let run = [];
|
|
138
|
+
let units = 0;
|
|
139
|
+
const flush = () => { if (run.length) { parts.push({ type: 'run', items: run }); run = []; } };
|
|
140
|
+
for (let i = 0; i < arr.length; i++) {
|
|
141
|
+
if (i === wordAt) {
|
|
142
|
+
flush();
|
|
143
|
+
const w = WORDS[tail];
|
|
144
|
+
const reading = lang === 'en' ? w.en[0] : w.ja;
|
|
145
|
+
parts.push({ type: 'word', text: reading });
|
|
146
|
+
units += lang === 'en' ? w.en[1] : countMora(w.ja);
|
|
147
|
+
for (const row of chars.slice(i)) row.inWord = reading;
|
|
148
|
+
break;
|
|
149
|
+
}
|
|
150
|
+
const row = chars[i];
|
|
151
|
+
if (SYMBOLS[arr[i]]) { flush(); parts.push({ type: 'sym', text: row.reading }); } else run.push(row.reading);
|
|
152
|
+
units += row.units;
|
|
153
|
+
}
|
|
154
|
+
flush();
|
|
155
|
+
const sepRun = lang === 'en' ? ' ' : '・';
|
|
156
|
+
const sepPart = lang === 'en' ? ', ' : ' ';
|
|
157
|
+
out.reading = parts.map((p) => (p.type === 'run' ? p.items.join(sepRun) : p.text)).join(sepPart);
|
|
158
|
+
out.units = units;
|
|
159
|
+
out.chars = chars;
|
|
160
|
+
out.facts = facts(text);
|
|
161
|
+
return out;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** 数えられる事実(読み方に依らない)。文字数・記号の種類・同じ文字の連続・数字の桁数・英字と数字の切り替わり */
|
|
165
|
+
export function facts(text) {
|
|
166
|
+
const arr = [...text];
|
|
167
|
+
const symbols = { hyphen: 0, underscore: 0, dot: 0, plus: 0 };
|
|
168
|
+
for (const ch of arr) {
|
|
169
|
+
if (ch === '-') symbols.hyphen++;
|
|
170
|
+
else if (ch === '_') symbols.underscore++;
|
|
171
|
+
else if (ch === '.') symbols.dot++;
|
|
172
|
+
else if (ch === '+') symbols.plus++;
|
|
173
|
+
}
|
|
174
|
+
const repeats = [];
|
|
175
|
+
for (let i = 0; i < arr.length;) {
|
|
176
|
+
let j = i + 1;
|
|
177
|
+
while (j < arr.length && arr[j] === arr[i]) j++;
|
|
178
|
+
if (j - i >= 2) repeats.push({ ch: arr[i], length: j - i, at: i });
|
|
179
|
+
i = j;
|
|
180
|
+
}
|
|
181
|
+
// 英字と数字の切り替わり: 記号を飛ばして、隣り合う英数字の種類が変わった回数
|
|
182
|
+
let switches = 0;
|
|
183
|
+
let prev = '';
|
|
184
|
+
for (const ch of arr) {
|
|
185
|
+
const k = /[a-z]/.test(ch) ? 'a' : /[0-9]/.test(ch) ? 'd' : '';
|
|
186
|
+
if (!k) continue;
|
|
187
|
+
if (prev && k !== prev) switches++;
|
|
188
|
+
prev = k;
|
|
189
|
+
}
|
|
190
|
+
return {
|
|
191
|
+
length: arr.length,
|
|
192
|
+
symbols,
|
|
193
|
+
symbolCount: symbols.hyphen + symbols.underscore + symbols.dot + symbols.plus,
|
|
194
|
+
repeats,
|
|
195
|
+
digits: arr.filter((ch) => /[0-9]/.test(ch)).length,
|
|
196
|
+
switches,
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** 伏せ字: 区切り(@ . - _ +)で分けた各まとまりの先頭1字だけ残し、残りを • にする */
|
|
201
|
+
export function mask(text) {
|
|
202
|
+
return String(text).replace(/[a-z0-9]+/g, (m) => m[0] + '•'.repeat(m.length - 1));
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** 候補の一覧を読む。並びは拍(en は音節)の短い順・同じなら入力順。読めない候補は後ろ */
|
|
206
|
+
export function analyze(input, opts = {}) {
|
|
207
|
+
const lang = opts.lang === 'en' ? 'en' : 'ja';
|
|
208
|
+
const { list, dropped } = splitCandidates(input);
|
|
209
|
+
const items = list.map((raw, i) => Object.assign({ label: String.fromCharCode(65 + i), index: i }, analyzeOne(raw, lang)));
|
|
210
|
+
const sorted = items.slice().sort((a, b) => (a.ok === b.ok ? (a.ok ? a.units - b.units : 0) || a.index - b.index : a.ok ? -1 : 1));
|
|
211
|
+
return { lang, unit: lang === 'en' ? 'syllables' : 'mora', items: sorted, dropped };
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/** 比べカードの1行の文(例「候補A 18拍・記号0」) */
|
|
215
|
+
export function cardLine(item, lang = 'ja', opts = {}) {
|
|
216
|
+
const name = opts.show ? item.text : opts.masked ? mask(item.text) : '';
|
|
217
|
+
if (lang === 'en') return 'Option ' + item.label + (name ? ' (' + name + ')' : '') + ': ' + item.units + ' syllable' + (item.units === 1 ? '' : 's') + ', ' + item.facts.symbolCount + ' symbol' + (item.facts.symbolCount === 1 ? '' : 's');
|
|
218
|
+
return '候補' + item.label + (name ? '(' + name + ')' : ' ') + item.units + '拍・記号' + item.facts.symbolCount;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/** 比べカードの文(読めた候補を拍の短い順に「/」でつなぐ) */
|
|
222
|
+
export function cardText(result, opts = {}) {
|
|
223
|
+
const lang = result.lang;
|
|
224
|
+
return result.items.filter((x) => x.ok).map((x) => cardLine(x, lang, opts)).join(lang === 'en' ? ' / ' : '/');
|
|
225
|
+
}
|
|
226
|
+
// ===== ここまでコア =====
|
|
227
|
+
|
|
228
|
+
// ---- MCP の入口 ----
|
|
229
|
+
export function emailReadAloudTool(opts = {}) {
|
|
230
|
+
const lang = opts.lang === 'en' ? 'en' : 'ja';
|
|
231
|
+
const input = opts.candidates;
|
|
232
|
+
if (!Array.isArray(input) && typeof input !== 'string') throw new EmailReadAloudError('NO_INPUT', 'candidates must be an array of strings (or a newline-separated string)');
|
|
233
|
+
const r = analyze(input, { lang });
|
|
234
|
+
if (!r.items.length) throw new EmailReadAloudError('NO_INPUT', 'no candidates (empty lines are skipped)');
|
|
235
|
+
const includeChars = opts.includeChars !== false;
|
|
236
|
+
const items = r.items.map((x) => {
|
|
237
|
+
const base = { label: x.label, index: x.index, input: x.input, ok: x.ok };
|
|
238
|
+
if (!x.ok) return { ...base, error: x.error };
|
|
239
|
+
const o = { ...base, text: x.text, kind: x.kind, reading: x.reading, units: x.units, unit: r.unit, facts: x.facts };
|
|
240
|
+
if (includeChars) o.chars = x.chars;
|
|
241
|
+
return o;
|
|
242
|
+
});
|
|
243
|
+
return {
|
|
244
|
+
lang,
|
|
245
|
+
unit: r.unit,
|
|
246
|
+
order: 'units ascending, then input order (not a ranking)',
|
|
247
|
+
items,
|
|
248
|
+
dropped: r.dropped,
|
|
249
|
+
card: cardText(r, { masked: true }),
|
|
250
|
+
phoneticSource: lang === 'en'
|
|
251
|
+
? "Japan's Radio Station Operation Rules, Appended Table 5 (same words as the international phonetic alphabet). https://laws.e-gov.go.jp/law/325M50080000017"
|
|
252
|
+
: '無線局運用規則 別表第五号「通話表」2 欧文通話表(数字は同表の国内通信の語)。https://laws.e-gov.go.jp/law/325M50080000017',
|
|
253
|
+
};
|
|
254
|
+
}
|
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営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表)・日本語タイトルからのURLスラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字)・AIが書いた返信案と届いたメールの照合(原文に無い日付・曜日・時刻・金額・数量・電話・宛名を赤、消し忘れの仮の文字を黄)・ComfyUI画像(PNG)の埋め込みデータに残ったAPIキーの形の点検(ノードIDと入力欄で場所を示し値は伏せる・持ち主へのお知らせ文・文字のチャンクを抜いたコピー)・GA4「トラフィック獲得」のCSVから AI Assistant と Organic Search
|
|
3
|
+
"version": "0.55.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の絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表)・日本語タイトルからのURLスラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字)・AIが書いた返信案と届いたメールの照合(原文に無い日付・曜日・時刻・金額・数量・電話・宛名を赤、消し忘れの仮の文字を黄)・ComfyUI画像(PNG)の埋め込みデータに残ったAPIキーの形の点検(ノードIDと入力欄で場所を示し値は伏せる・持ち主へのお知らせ文・文字のチャンクを抜いたコピー)・GA4「トラフィック獲得」のCSVから AI Assistant と Organic Search の訪問をエンゲージメント率・平均エンゲージメント時間・キーイベント率で比べる集計(倍率・総計行との突き合わせ・除外した行の行番号・要約)・メールアドレス候補の読み上げ文と拍数(記号・同じ文字の連続・数字の桁数などの数え上げと欧文通話表の1文字ずつの表))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ41本(GEO・メタタグ・セキュリティヘッダー・SSL・DNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・ビジネス文面チェック等)の JSON API を呼ぶ app_* ツールも提供する(こちらは入力を apps.first-ch.com へ送るため既定では無効・FIRSTCH_ENABLE_APPS=1 で有効)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"firstch-tools-mcp": "server.mjs"
|
|
@@ -23,6 +23,8 @@
|
|
|
23
23
|
"keywords": [
|
|
24
24
|
"mcp",
|
|
25
25
|
"text-fit",
|
|
26
|
+
"email-address",
|
|
27
|
+
"phonetic-alphabet",
|
|
26
28
|
"japanese-address",
|
|
27
29
|
"kanji-numerals",
|
|
28
30
|
"daiji",
|
|
@@ -283,6 +285,7 @@
|
|
|
283
285
|
"invoice-nebiki.mjs",
|
|
284
286
|
"comfy-png-leak.mjs",
|
|
285
287
|
"ai-vs-search.mjs",
|
|
288
|
+
"email-read-aloud.mjs",
|
|
286
289
|
"reply-check.mjs",
|
|
287
290
|
"webp.mjs",
|
|
288
291
|
"marp.mjs",
|
package/server.mjs
CHANGED
|
@@ -50,6 +50,7 @@ import { fitToBoxTool } from './fit-to-box.mjs';
|
|
|
50
50
|
import { invoiceNebikiTool } from './invoice-nebiki.mjs';
|
|
51
51
|
import { comfyPngLeakTool } from './comfy-png-leak.mjs';
|
|
52
52
|
import { aiVsSearchTool } from './ai-vs-search.mjs';
|
|
53
|
+
import { emailReadAloudTool } from './email-read-aloud.mjs';
|
|
53
54
|
import { replyCheckTool } from './reply-check.mjs';
|
|
54
55
|
|
|
55
56
|
const { version } = createRequire(import.meta.url)('./package.json');
|
|
@@ -2115,4 +2116,28 @@ registerTool(
|
|
|
2115
2116
|
},
|
|
2116
2117
|
);
|
|
2117
2118
|
|
|
2119
|
+
registerTool(
|
|
2120
|
+
'email_read_aloud',
|
|
2121
|
+
{
|
|
2122
|
+
title: 'メールアドレス候補の読み上げの長さ比べ',
|
|
2123
|
+
description:
|
|
2124
|
+
'メールアドレスかドメインの候補(candidates・最大5件。6件目以降は dropped に件数)ごとに、電話で言うときの読み上げ文と長さを返す(tools.first-ch.com/mail-yomiage/ と同一ロジック)。' +
|
|
2125
|
+
'入力は NFKC で半角に・小文字にそろえ、前後の空白と mailto: を外す。英字・数字は1字ずつ(ja はカタカナ・en は英語の文字名)、@=アットマーク/at・.=ドット/dot・-=ハイフン/hyphen・_=アンダーバー/underscore・+=プラス/plus と読み、末尾が .com・.net のときだけ語で読む。' +
|
|
2126
|
+
'units は ja ならカタカナの拍(小書きのャュョァィゥェォは前の字と1拍・ッ・ン・ーは1拍)、en なら音節。items は units の短い順(同じなら入力順)で、label(A〜E)は入力順。順位・おすすめではない。' +
|
|
2127
|
+
'facts は length(文字数)・symbols(hyphen / underscore / dot / plus の数。@ は数えない)・symbolCount・repeats(同じ文字が2つ以上続く箇所)・digits(数字の桁数)・switches(英字と数字の切り替わり回数・記号は飛ばす)。' +
|
|
2128
|
+
'chars(includeChars:false で省く)は1文字ずつの reading・units・phonetic(無線局運用規則 別表第五号の欧文通話表の語と発音〔ITU と同じ語〕。数字は ja が国内通信の「数字のまる」等、en が航空移動業務の ZERO/WUN 等)・alt(日本語の言い換え例。決まった表ではない)。' +
|
|
2129
|
+
'読めない候補は ok:false と error.code(BAD_CHAR〔chars に該当文字〕/ MULTI_AT / EMPTY_PART / TOO_LONG〔254文字超〕)。card は比べカードの文(アドレスは伏せ字)。' +
|
|
2130
|
+
'伝わりやすさの順位・見た目の似た文字の判定・ドメインの空き確認・実在確認・音声・候補の生成はしない。完全ローカル処理・ネットワーク送信なし。',
|
|
2131
|
+
inputSchema: {
|
|
2132
|
+
candidates: z.array(z.string()).describe('メールアドレスかドメインの候補(最大5件。改行区切りの1つの文字列でも可)'),
|
|
2133
|
+
lang: z.enum(['ja', 'en']).optional().describe("読み上げ文と長さの言語(既定 'ja'=カタカナの拍、'en'=英語の文字名と音節)"),
|
|
2134
|
+
includeChars: z.boolean().optional().describe('1文字ずつの表(chars)を返すか(既定 true)'),
|
|
2135
|
+
},
|
|
2136
|
+
},
|
|
2137
|
+
async (opts) => {
|
|
2138
|
+
await logUsage('email_read_aloud');
|
|
2139
|
+
return asText(emailReadAloudTool(opts));
|
|
2140
|
+
},
|
|
2141
|
+
);
|
|
2142
|
+
|
|
2118
2143
|
serveStdio(buildServer);
|