🇯🇵 japan-ux-mcp
Japan Design — AIコーディングエージェントのためのUI + UX正確性。 フロントエンドのエンフォーサーです。実際のCSS/マークアップを渡すと、日本語標準に基づいてUIを採点します — タイポグラフィ(禁則処理、行高、フォント)、色の象徴性、フォントパフォーマンス — W3C JLReq / JIS X 4051 の引用と修正案付き。さらにUXレイヤー全体:フォーム(姓名/フリガナ)、敬語、信頼シグナル、法務、季節デザインをカバーします。
メインツール:review_jp_ui — フロントエンド正確性エンフォーサー(西洋製を含むあらゆるUIを、日本向けリリース前に実行してください)。
11のツール、10のプロンプト、9のリソース。ローカルで動作し、APIキーは不要です。検出結果は spec(JLReq/JIS)と convention(文書化された日本のWeb慣行)に分類されるため、権威を過大に主張することはありません。
🚀 クイックスタート
📦 インストール
claude mcp add japan-ux -- npx -y japan-ux-mcp
🛠️ JSON設定
サーバー設定はクライアント間で共通で、ファイルパスのみが異なります。
Claude Code — ~/.claude/.mcp.json
{
"mcpServers": {
"japan-ux": { "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}
Cursor — ~/.cursor/mcp.json
{
"mcpServers": {
"japan-ux": { "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}
Windsurf — ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"japan-ux": { "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}
VS Code (GitHub Copilot) — .vscode/mcp.json
{
"servers": {
"japan-ux": { "type": "stdio", "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}
Cline (VS Code拡張機能)
ClineのMCP設定パネルを開き、以下を追加します:
{
"mcpServers": {
"japan-ux": { "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}
Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"japan-ux": { "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}
設定パス:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Zed — ~/.config/zed/settings.json
{
"context_servers": {
"japan-ux": { "command": { "path": "npx", "args": ["-y", "japan-ux-mcp"] } }
}
}
🧱 ソースからビルド
git clone https://github.com/mrslbt/japan-ux-mcp.git
cd japan-ux-mcp
npm install && npm run build
クライアント設定をビルド済みエントリポイントに向けます:
{ "command": "node", "args": ["/absolute/path/to/japan-ux-mcp/dist/index.js"] }
🔧 ツール
| ツール |
説明 |
review_jp_ui |
主力エンフォーサー — 日本語UI標準(タイポグラフィ、色、フォントペイロード)に対してCSS/マークアップを採点し、JLReq/JIS引用と修正案を提示。 |
generate_jp_form |
日本語フォームのマークアップを出力:姓/名の順序、フリガナ、〒郵便番号自動入力、3分割電話番号、年月日。 |
validate_jp_form |
日本の慣習に対してフォームを採点(0〜100)。問題点、重要度、コード修正を提示。 |
generate_jp_placeholder |
テストデータを返す:漢字/カタカナ/ローマ字の名前、実際の郵便番号、整形された電話番号、元号日付。 |
suggest_keigo_level |
与えられたビジネス文脈に適した敬語レベルで、英語UIテキストを日本語に変換。 |
score_japan_readiness |
5つのカテゴリ(フォーム、コピー、信頼シグナル、タイポグラフィ、文化的適合性)でページを評価。 |
transform_for_japan |
西洋のマークアップを日本向けマークアップに書き換え、変更前後のスコアと変更ごとの説明を提示。 |
check_jp_typography |
日本語タイポグラフィのためにCSSを監査:フォントスタック、行高、禁則処理、サイズ、palt。 |
get_seasonal_context |
現在の季節、開催中のイベント、二十四節気、リリース禁止期間を返す。 |
audit_japan_ux |
7カテゴリ監査(レイアウト、タイポグラフィ、ビジュアル、ナビゲーション、信頼、コンテンツ、モバイル)でレターグレードを付与。 |
design_direction_for_japan |
ブランドタイプ、オーディエンス、業界から日本向けデザインブリーフを生成。 |
💬 プロンプト
| プロンプト |
説明 |
japan_form |
日本語フォームの構築を順を追って案内。 |
japan_audit |
貼り付けられたマークアップのJP UX問題を監査。 |
japan_transform |
西洋のマークアップを変更前後のスコア付きで変換。 |
japan_testdata |
プロトタイプ用の日本語テストデータを生成。 |
japan_keigo |
適切な敬語レベルでUIテキストを返す。 |
japan_score |
ページの説明を日本対応度で採点。 |
japan_typography |
日本語タイポグラフィの問題についてCSSをチェック。 |
japan_seasonal |
特定の月の季節デザインコンテキストを返す。 |
japan_full_audit |
7カテゴリの日本語UX監査を実行。 |
japan_design_direction |
日本向けのビジュアルディレクションを生成。 |
📚 リソース
| リソース |
内容 |
keigo-guide |
8つのビジネス文脈にわたる4つの敬語レベル、30以上のUIコピーパターン。 |
form-checklist |
リリース前レビュー用の日本語フォーム慣習。 |
phone-formats |
携帯、固定、フリーダイヤル、IP電話のパターンとフィールド分割ルール。 |
era-calendar |
令和から明治まで、日付範囲と変換式付き。 |
typography-guide |
フォントスタック、タイプスケール、行高、禁則処理、CSS提案。 |
seasonal-calendar |
24のイベント、二十四節気、季節パレット、リリース禁止日。 |
trust-checklist |
サイト種別ごとの信頼シグナル、法務ページ、社会的証明。 |
color-guide |
日本の色の意味、赤い名前の禁忌、ビジュアルデザインルール。 |
layout-guide |
グリッド、間隔、密度、レスポンシブブレークポイント、構造パターン。 |
💻 使用例
Build a registration form for a Japanese B2B SaaS product. Include name,
email, phone, company, and address. Use TSX with Tailwind.
Audit this form for Japanese conventions:
<form>
<input name="firstName" placeholder="First Name" />
<input name="lastName" placeholder="Last Name" />
<input name="email" />
<input name="phone" />
<button>Submit</button>
</form>
Transform this form for the Japanese market (fintech context):
<form>
<label>First Name <input name="firstName" /></label>
<label>Last Name <input name="lastName" /></label>
<label>Phone <input name="phone" /></label>
<label>Address <input name="address" /></label>
<button type="submit">Submit</button>
</form>
I need Japanese UI copy for a banking app:
- Error: "Invalid email address"
- Button: "Submit application"
- Empty state: "No transactions yet"
- Confirmation: "Are you sure you want to delete?"
Check this CSS for Japanese typography issues:
body { font-family: Arial; font-size: 14px; line-height: 1.4; font-style: italic; }
Run a Japanese UX audit on this B2B SaaS landing page. Hero with English
tagline, feature grid, pricing table, no phone number in header, no
company info page, single-column layout.
🗂️ 同梱データ
すべてのデータはパッケージに同梱されています。外部API、キー、ネットワーク呼び出しはありません。
| データ |
数 |
詳細 |
| 都道府県 |
47 |
コード、名称、かな、ローマ字、地域 |
| 名前 |
100 |
50の姓 + 50の名(漢字/かな/ローマ字) |
| 住所 |
12 |
主要都市の実際の郵便番号 |
| 電話番号形式 |
6 |
携帯、固定、フリーダイヤル、IP、ナビダイヤル |
| 元号 |
5 |
令和から明治、開始/終了日付 |
| 敬語パターン |
30 |
9つの要素タイプにわたる4つの敬語レベルのUI文字列 |
| 文字幅ルール |
6 |
フィールドタイプごとの全角/半角バリデーション |
| レイアウトルール |
28 |
グリッド、間隔、密度、レスポンシブ、構造パターン |
| タイポグラフィルール |
24 |
フォントスタック、サイズ、行高、折り返し、レンダリング |
| フォントスタック |
7 |
システム、Web、セリフ、モダン/エレガント/ラウンド/コーポレートの混在 |
| ビジュアルルール |
21 |
色の意味、画像、アイコン、影、角丸 |
| ナビゲーションルール |
16 |
ヘッダー、フッター、メニュー、検索、パンくず、ページネーション |
| 信頼シグナル |
20 |
会社情報、社会的証明、認証、連絡先 |
| 法的要件 |
10 |
特定商取引法、APPI、景品表示法、薬機法など |
| 季節イベント |
25 |
通年、デザインへの影響とビジネスノート付き |
| 二十四節気 |
24 |
およその日付付き |
| 色の意味 |
9 |
日本特有の色の連想と16進数値 |
| プラットフォームパターン |
30+ |
LINE、QRコード、モバイル決済、IME処理、ソーシャル共有 |
| アクセシビリティルール |
20+ |
JIS X 8341-3、高齢化社会、スクリーンリーダー、フリガナ |
| コンテンツパターン |
15+ |
密度、コピー、商品ページ、ローカライズルール |
📐 対応する慣習
📝 フォームと入力
| 慣習 |
実践 |
| 名前の順序 |
姓(姓)が先、名(名)が後 |
| フリガナ |
各名前入力の下にカタカナ読みフィールド(セイ/メイ) |
| 電話番号 |
3つの別々のフィールド。パターン:XXX-XXXX-XXXX |
| 住所 |
〒郵便番号が都道府県 + 市区町村を自動入力。大から小への順序 |
| 日付 |
年/月/日の個別入力、任意で元号表示(令和6年 = 2024) |
| 文字幅 |
入力時に全角数字と記号を半角へ自動変換 |
| 確認 |
最終送信前の確認画面 |
🔤 タイポグラフィ
| 慣習 |
実践 |
| イタリックなし |
日本語にイタリック体はない。強調には太字、色、サイズを使用 |
| 行高 1.8+ |
漢字の密度はラテン文字より縦方向のスペースを必要とする |
| 本文16px以上 |
漢字の可読性は14px未満で崩れる |
| 禁則処理 |
word-break: keep-all + line-break: strict。句読点で行を開始しない |
| フォントスタック |
Hiragino Sans、Yu Gothic、Meiryoのカスケード。WebフォントはNoto Sans JP |
| 英日混在 |
英語フォント優先、日本語フォールバック:"Inter", "Noto Sans JP", sans-serif |
📏 レイアウトと構造
| 慣習 |
実践 |
| 情報密度 |
密なレイアウトが信頼される。疎なものは情報を隠していると読まれる |
| 1280px PC / 375px モバイル |
標準アートボードサイズ、左右余白140〜160px |
| セクション間隔 |
主要セクション間100px(PC)、モバイルは60px |
| 交互ジグザグ |
画像左/テキスト右、次に反転。日本のLPで標準 |
| パンくず |
すべての下層ページで必須 |
| CTAの繰り返し |
複数のスクロール地点にコンバージョンボタンを配置 |
🤝 信頼と法務
| 慣習 |
実践 |
| 特定商取引法 |
ECで必須の法的開示。販売者情報、返品、支払い |
| 会社概要 |
住所、代表者名、資本金、設立年を含む会社プロフィールページ |
| ヘッダーの電話番号 |
目に見える電話番号は正当性を示す。0120フリーダイヤルが好まれる |
| プライバシーポリシー |
APPI(2022年4月改正)が要求する個人情報保護方針 |
| 実績数値 |
ヒーロー付近に具体的な指標:1,247社導入、業務効率30%改善 |
| 敬語 |
8つのビジネス文脈にマッピングされた4つの敬語レベル |
🎨 ビジュアルと色
| 慣習 |
実践 |
| 赤 = 繁栄 |
危険ではない。プライマリブランドカラーとして自由に使用される |
| 赤い名前なし |
白地に赤の名前は死の連想を伴う。暗いテキストを使用 |
| 白黒のみ |
葬儀の連想。アクセントカラーを追加 |
| 明るいパレット |
密でカラフルなレイアウトが普通。ダークテーマの採用は西洋より遅い |
| マンガ/アニメのイラスト |
銀行や政府を含む業界全体で使用される |
🍃 季節
| 慣習 |
実践 |
| 四季、二十四節気 |
それぞれに異なるカラーパレットとデザインモチーフ |
| ゴールデンウィーク(4月29日〜5月5日) |
リリース禁止。ほとんどの企業が休業 |
| お盆(8月13〜16日) |
リリース禁止。移動のピーク |
| クリスマスはロマンチック |
カップルが祝う。家族は正月に集まる |
| お中元 / お歳暮 |
中間期と年末のギフトシーズン。主要なECウィンドウ |
🖥️ クライアント対応
| クライアント |
対応 |
| Claude Code |
ツール、プロンプト、リソース |
| Cursor |
ツール、プロンプト、リソース |
| Windsurf |
ツール、プロンプト、リソース |
| VS Code (GitHub Copilot) |
ツール、プロンプト、リソース |
| Cline |
ツール、プロンプト、リソース |
| Claude Desktop |
ツール、プロンプト、リソース |
| Zed |
ツール、リソース |
| 任意のstdio MCPクライアント |
ツール、プロンプト、リソース |
🇯🇵 日本語
日本のWeb UX慣習のためのMCPサーバーです。姓名順、フリガナ、3分割電話番号、〒住所フロー、敬語レベル、タイポグラフィ、信頼シグナル、特定商取引法などの法要件、季節デザインをツール・プロンプト・リソースとして提供します。
Claude Code、Cursor、Windsurf など MCP 対応クライアントで動作します。ローカル動作、APIキー不要。
⚠️ 免責事項
このサーバーは、日本向け製品を構築するためのガイダンス、スタイルルール、文化的コンテキストを返します。いかなるブランドのAPIも呼び出さず、ブランドを代表して行動することもありません。例や推奨に登場する会社名やサービス名(銀行、携帯キャリア、決済サービス、配送会社など)は、日本にいるユーザーへの文化的コンテキストとして参照されるものであり、推奨や提携を意味するものではありません。すべての商標は各所有者に帰属します。
📄 ライセンス
MIT
🌐 その他のMCP
| MCP |
機能 |
| rippr |
人とAIエージェントのためのYouTubeトランスクリプト抽出ツール |
| Rakuten |
楽天のマーケットプレイス、書籍、ホテルを検索 |
| Xendit |
Xendit決済API:請求書、送金、残高 |
東京にて Marsel Bait が開発