@first-ch/tools-mcp 0.55.0 → 0.56.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 +4 -2
- package/apps.mjs +24 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
MCP server exposing [First CH Tools](https://tools.first-ch.com)' free web-tool logic — WCAG contrast, JP character/X-weight counting, WebP conversion, JSON-LD generation, llms.txt generation, encoding/line-ending conversion, Marp Markdown→slide rendering, Japanese/English test-data generation, text/code diffing, cron-expression explanation, Base64/data-URI encoding, URL query-parameter editing, HTML entity escaping/unescaping, JSON⇄YAML conversion, px ⇄ rem/em unit conversion, colour-code conversion with alpha compositing, MD5/SHA-1/SHA-256/SHA-384/SHA-512 hashing, JWT decoding with expiry and signature checks, User-Agent parsing with device/bot detection, bulk UUID v4 / ULID generation, aspect-ratio calculation with responsive sizing, case conversion between camelCase, snake_case and kebab-case, CSV/TSV ⇄ JSON conversion, IP/CIDR calculation with subnet splitting and IP-range reduction, business-day date calculation with Japanese public holidays, HTML-to-Markdown conversion, Japanese era ⇄ Western date conversion with age calculation, and URL-slug generation from Japanese titles — to AI agents such as Claude Code. All of those run on your machine.
|
|
4
4
|
|
|
5
|
-
It also ships **`app_*` tools** for the
|
|
5
|
+
It also ships **`app_*` tools** for the 42 web apps at [apps.first-ch.com](https://apps.first-ch.com) (site checks such as GEO/AI-search readiness, meta tags, security headers, SSL certificates, DNS and email DNS, redirects, broken links, structured data, AI-crawler access, Japanese readability, and AI-assisted business-tone and LP-copy checks). Unlike the local tools, **an `app_*` tool sends its input (a URL, domain name or text) to apps.first-ch.com** and returns the JSON the app's API responds with — see [Network access, files and privacy](#network-access-files-and-privacy).
|
|
6
6
|
|
|
7
7
|
日本語版は [後半セクション](#日本語) を参照してください。
|
|
8
8
|
|
|
@@ -145,6 +145,7 @@ Each `app_*` tool calls one app's public JSON API (`POST https://apps.first-ch.c
|
|
|
145
145
|
| `app_henji_kuru` | [Count LINE Attendance Replies by Pasting the Chat](https://apps.first-ch.com/en/henji-kuru/) — AI check for the replies to a LINE group attendance call (○ going / × not going / △ not sure) that do not fit the format, such as “me too” or “absent for the previous one”. Send 1–10 rows (the reply and, optionally, the message before it) and get a category (yes / no / maybe / unclear), head count and short reason per row. The server masks phone numbers, e-mail addresses, @mentions and names before さん, but mask names yourself before sending. Tallying the whole chat runs in the browser on the page, not in this API. Shares the AI rate limits. | `lines`[], `count?` |
|
|
146
146
|
| `app_notice_check` | [Leftover Placeholder Text Checker](https://apps.first-ch.com/en/notice-check/) — Fetches the home page and up to 6 same-site pages from its navigation (512KB each, 12s in total) and returns leftover candidates in 6 kinds: Japanese dummy-copy phrases, placeholder values (〇〇, 【会社名】, 000-0000-0000), lorem ipsum, WordPress defaults (Hello world!, Sample Page, Just another WordPress site), demo/placehold images and links to localhost or staging. Each page gets a state (checked / unreadable for JavaScript-drawn pages / failed / limit) plus the matched text, a short excerpt and the nearest heading; unchecked pages are not counted as checked. Pages themselves are never returned. 10 calls per 10 minutes per IP. | `url` |
|
|
147
147
|
| `app_site_freshness` | [Expired Notice Finder](https://apps.first-ch.com/en/site-freshness/) — Reads only the fetched HTML of the one page you enter (first 512KB, up to 8s; other pages, PDFs and JavaScript-drawn text are not checked) and returns notices still on the page after their end date: places where a date with a year (2025年12月28日, 2025/12/28, 2025.12.28) and a notice word (休業, 休診, 臨時休業, 営業時間, 開催, 説明会, キャンペーン, セール, 受付, 締切) appear in the same sentence and the end date is before today in Japan time. Periods are compared by their end date; posting dates (time elements, a date alone at the start of a list row) are left out. Each candidate has the kind, end date, days since and a 30-character excerpt on each side; dates without a year or that do not exist are listed separately and not counted. For Japanese-language pages. The page itself is never returned. 20 calls per 10 minutes per IP. | `url` |
|
|
148
|
+
| `app_mibare_check` | [Hide the Nearest Station (daily puzzle)](https://apps.first-ch.com/en/mibare-check/) — For the day's shared puzzle (a fictional town with 8 stations and 8 casual posts c1–c8 by a fictional person), pick up to 2 posts to rewrite and get the number of candidate stations left; with `final: true` it also returns the pair that gave the station away, how many stations each fits alone, the share of the 28 two-post choices that still leave one station, and share text. Sends only the date and post IDs; no real people or places, and it never takes your own posts or URLs. |
|
|
148
149
|
|
|
149
150
|
See [`server.mjs`](./server.mjs) for the exact Zod input schemas of the local tools and [`apps.mjs`](./apps.mjs) for the `app_*` tools.
|
|
150
151
|
|
|
@@ -200,7 +201,7 @@ Release rule: a push to `main` automatically publishes a new package version thr
|
|
|
200
201
|
|
|
201
202
|
`@first-ch/tools-mcp` は、[First CH Tools](https://tools.first-ch.com)(無料Webツール集)の計算ロジック — 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の一括生成・アスペクト比の計算とレスポンシブサイズの算出・camelCase / snake_case / kebab-case などの文字列ケース変換・CSV/TSV ⇄ JSON の相互変換・日数/営業日の計算(日本の祝日を内蔵)・HTML→Markdownの変換・和暦⇄西暦の変換と満年齢の計算・日本語タイトルからのURLスラッグ生成 — をAIエージェント(Claude Code等)向けMCPツールとして提供するサーバーです。これらは全て端末内で処理します。
|
|
202
203
|
|
|
203
|
-
あわせて、[apps.first-ch.com](https://apps.first-ch.com) のWebアプリ
|
|
204
|
+
あわせて、[apps.first-ch.com](https://apps.first-ch.com) のWebアプリ42本(GEO・メタタグ・セキュリティヘッダー・SSL証明書・DNS/メールDNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・AIによるビジネス文面/LP文言のチェックなど)を呼ぶ **`app_*` ツール**も提供します。**`app_*` ツールは入力(URL・ドメイン名・文面)を apps.first-ch.com のサーバーへ送り**、アプリの API が返した JSON を返します(端末内で完結する他のツールとはここが違います)。詳しくは [通信・ファイル・プライバシー](#通信ファイルプライバシー) を参照してください。
|
|
204
205
|
|
|
205
206
|
### インストール
|
|
206
207
|
|
|
@@ -341,6 +342,7 @@ claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp
|
|
|
341
342
|
| `app_henji_kuru` | [LINEの出欠の返事を貼るだけで数える|出欠集計](https://apps.first-ch.com/henji-kuru/) — LINEグループの出欠確認(○=参加・×=不参加・△=未定)への返事のうち、「私も」「前の件は欠席」など型に合わない行を1〜10行受け取り、行ごとに区分(yes / no / maybe / unclear)・人数・短い理由を返す(AI)。各行は返事と任意の直前の発言。サーバーでも電話・メール・@・「〜さん」の前の名前を伏せるが、名前は送る前に伏せておく。トーク履歴全体の集計はページの端末内の処理で、この API は行わない。AI の回数制限は共通。 | `lines`[], `count?` |
|
|
342
343
|
| `app_notice_check` | [公開直後のダミーテキスト・消し忘れチェック](https://apps.first-ch.com/notice-check/) — 公開URLのトップと、ナビにある同じサイトのページを最大6本(各512KB・全体12秒まで)取得し、日本語ダミー文の定型句・仮の値(〇〇・【会社名】・000-0000-0000)・lorem ipsum・WordPress の初期状態(Hello world!・サンプルページ・Just another WordPress site)・デモ/placehold 系の画像・localhost や staging へのリンクの6種類で消し忘れ候補を返す。ページごとに状態(検査済み・JavaScript で描くページ等の未検査・取得不能・12秒の上限)と、一致した語句・前後の短い抜粋・直近の見出しを返し、未検査のページは検査済みに数えない。ページの原文は返さない。同じIPから10分に10回まで。 | `url` |
|
|
343
344
|
| `app_site_freshness` | [終わった告知の残り探し](https://apps.first-ch.com/site-freshness/) — 入力した1ページの取得HTMLだけ(先頭512KB・8秒まで。他ページ・PDF・JavaScript で出る本文は見ない)を読み、年付きの日付(2025年12月28日・2025/12/28・2025.12.28)と同じ文の中の告知語(休業・休診・臨時休業・営業時間・開催・説明会・キャンペーン・セール・受付・締切)がそろい、終了日が日本時間の今日より前の告知候補を返す。期間は終了日で比べ、time 要素や一覧の行頭にある掲載日は外す。候補ごとに種別・終了日・何日過ぎたか・前後30字の抜粋を返し、年なし・実在しない日付は「読めなかった日付」に分けて件数に入れない。ページの原文は返さない。同じIPから10分に20回まで。 | `url` |
|
|
345
|
+
| `app_mibare_check` | [最寄り駅を隠す毎日1問](https://apps.first-ch.com/mibare-check/) — 全員共通のその日の1問(架空の町の8駅と、架空の人の何気ない投稿8件 c1〜c8)で、言い換える投稿を2件まで選ぶと残る候補駅の数を返す。`final: true` で、1駅に絞り込んでいた2件の組み合わせ・それぞれ単独で当てはまる駅の数・2か所の選び方28通りのうち直しても1駅のまま残る割合・共有用の文も返す。送るのは日付と投稿の番号だけ。実在の人・地名は扱わず、利用者の投稿文やURLは受け取らない。 |
|
|
344
346
|
|
|
345
347
|
正確な入力スキーマ(Zod定義)は、端末内のツールが [`server.mjs`](./server.mjs)、`app_*` ツールが [`apps.mjs`](./apps.mjs) を参照してください。
|
|
346
348
|
|
package/apps.mjs
CHANGED
|
@@ -527,6 +527,30 @@ const DEFS = [
|
|
|
527
527
|
'先頭は候補件数・確認した範囲(KB と打ち切りの有無)・次にすることの3段。日本語のページ向け。機械的な抽出のため、記録として残す告知も候補に出る。ページの原文は返さない。同じIPから10分に20回まで。',
|
|
528
528
|
{ urlLabel: '確認するページのURL' },
|
|
529
529
|
),
|
|
530
|
+
{
|
|
531
|
+
slug: 'mibare-check',
|
|
532
|
+
apiPath: '/mibare-check/api/check',
|
|
533
|
+
title: '最寄り駅を隠す毎日1問(架空の人の投稿を2か所だけ直す)',
|
|
534
|
+
summary:
|
|
535
|
+
'日本時間の日付ごとに全員共通の1問(架空の町の8駅と、架空の人の何気ない投稿8件 c1〜c8)について、言い換える投稿を2件まで選ぶと、残る候補駅の数と駅の番号を返す。' +
|
|
536
|
+
'final を true にすると答え合わせも返す: 最も効いた2件の組み合わせ(手がかりID と見出し)・それぞれ単独で当てはまる駅の数・2件が重なって1駅になる経緯・各投稿の単独の駅数・2か所の選び方28通りのうち直しても1駅のまま残る割合・共有用の文。' +
|
|
537
|
+
'投稿の文はページ(apps.first-ch.com/mibare-check/)にだけあり、この API は文を返さない。実在の人・地名は扱わず、利用者の投稿文やURLは受け取らない。同じIPから10分に240回まで。',
|
|
538
|
+
sends: '問題の日付と選んだ投稿の番号',
|
|
539
|
+
inputSchema: {
|
|
540
|
+
day: z
|
|
541
|
+
.string()
|
|
542
|
+
.regex(/^\d{4}-\d{2}-\d{2}$/)
|
|
543
|
+
.optional()
|
|
544
|
+
.describe('問題の日付(YYYY-MM-DD・日本時間の今日か前日。省略時は今日)'),
|
|
545
|
+
picks: z
|
|
546
|
+
.array(z.enum(['c1', 'c2', 'c3', 'c4', 'c5', 'c6', 'c7', 'c8']))
|
|
547
|
+
.max(2)
|
|
548
|
+
.optional()
|
|
549
|
+
.describe('言い換える投稿の手がかりID(c1〜c8・重複なしで2件まで。省略時は0件)'),
|
|
550
|
+
final: z.boolean().optional().describe('true なら答え合わせ(result)も返す。既定 false'),
|
|
551
|
+
lang: LANG,
|
|
552
|
+
},
|
|
553
|
+
},
|
|
530
554
|
];
|
|
531
555
|
|
|
532
556
|
const toolName = (slug) => `app_${slug.replace(/-/g, '_')}`;
|
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 の訪問をエンゲージメント率・平均エンゲージメント時間・キーイベント率で比べる集計(倍率・総計行との突き合わせ・除外した行の行番号・要約)・メールアドレス候補の読み上げ文と拍数(記号・同じ文字の連続・数字の桁数などの数え上げと欧文通話表の1文字ずつの表))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ
|
|
3
|
+
"version": "0.56.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アプリ42本(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"
|