japan-ux について
japan-uxは、コーディングエージェント向けに日本向けインターフェースを検査し、UI・UXの調整を支援するMCPサーバーです。規格に基づくタイポグラフィ検査に加え、フォーム、表現、信頼性、法的情報、季節デザインの慣習を扱います。
主な機能
- 01JLReq/JISの引用付きCSS・マークアップ検査
- 02日本語フォームの生成と検証
- 03ビジネス状況に応じた敬語の提案
- 04日本向け適合度の評価とUX監査
- 05タイポグラフィと季節性の確認
活用シーン
- 01日本向けページの公開前レビュー
- 02日本語の登録フォーム作成
- 03ビジネス状況に応じた英語UI文言の調整
- 04CSSの日本語タイポグラフィ検査
MCP 対応
日本語UI・UX作業向けのツール、プロンプト、参照リソースをMCPクライアントに提供します。APIキー不要でローカル動作します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
11掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| css | string | はい | 日本の UI 標準に照らしてレビューする CSS の内容。 |
| markup | string | いいえ | コンテキスト用の任意の HTML/JSX markup(例:写真上のテキスト検出)。 |
| context | enum | いいえ | 推奨フォントスタックのデザインコンテキスト。corporate | editorial | casual | luxury |
詳細
japan-ux-mcp
Japan Design — AI コーディングエージェント向けの UI + UX の正確性。 フロントエンドの強制チェッカーです。実際の CSS/マークアップを渡すと、日本の標準に照らして UI を評価します。タイポグラフィ(禁則処理、行の高さ、フォント)、色の象徴性、フォントのパフォーマンスを、W3C JLReq/JIS X 4051 の引用と修正案とともに確認します。さらに、フォーム(姓名/ふりがな)、敬語、信頼性を高める要素、法務、季節のデザインを含む UX の全領域にも対応します。
主要ツール:review_jp_ui — フロントエンドの正確性を強制的にチェックします(日本向けに公開する前に、西洋の設計で作られたものも含め、あらゆる UI に対して実行できます)。
11 個のツール、10 個のプロンプト、9 個のリソースを提供します。ローカルで動作し、API キーは不要です。検出結果は仕様(JLReq/JIS)と慣例(文書化された日本のウェブ慣行)に分類されるため、根拠の権威性を誇張しません。
インストール
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 | 現在の季節、開催中のイベント、24 のマイクロシーズン(二十四節気)、ローンチを避けるべき期間を返します。 |
audit_japan_ux | 7 つのカテゴリー(レイアウト、タイポグラフィ、ビジュアル、ナビゲーション、信頼性、コンテンツ、モバイル)を監査し、レターグレードで評価します。 |
design_direction_for_japan | ブランドの種類、対象者、業界に基づき、日本向けのデザインブリーフを作成します。 |
プロンプト
| プロンプト | 説明 |
|---|---|
japan_form | 日本語フォームの作成手順を案内します。 |
japan_audit | 貼り付けられたマークアップを監査し、日本語 UX の問題を確認します。 |
japan_transform | 変換前後のスコアを付けながら、西洋風のマークアップを変換します。 |
japan_testdata | プロトタイプ用の日本語テストデータを生成します。 |
japan_keigo | 適切な丁寧さのレベルで UI テキストを返します。 |
japan_score | ページの説明を、日本市場への対応度に基づいて採点します。 |
japan_typography | CSS に日本語組版の問題がないか確認します。 |
japan_seasonal | 特定の月に合わせた季節のデザインコンテキストを返します。 |
japan_full_audit | 日本語 UX を7つのカテゴリーで全面的に監査します。 |
japan_design_direction | 日本市場向けのビジュアルデザイン方針を生成します。 |
リソース
| リソース | 内容 |
|---|---|
keigo-guide | 8つのビジネスコンテキストにおける4段階の丁寧さ、30種類以上の UI コピーのパターン。 |
form-checklist | 公開前のレビュー用、日本語フォームの慣習。 |
phone-formats | 携帯電話、固定電話、フリーダイヤル、IP 電話のパターンと項目分割のルール。 |
era-calendar | 令和から明治までの期間と換算式。 |
typography-guide | フォントスタック、文字サイズのスケール、行の高さ、禁則処理、CSS の提案。 |
seasonal-calendar | 24の行事、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 | システム、ウェブ、セリフ、モダン・エレガント・丸み・コーポレートの各ミックス |
| ビジュアルのルール | 21 | 色の意味、画像、アイコン、影、角 |
| ナビゲーションのルール | 16 | ヘッダー、フッター、メニュー、検索、パンくずリスト、ページネーション |
| 信頼性を示す情報 | 20 | 会社情報、社会的証明、認証、連絡先 |
| 法的要件 | 10 | 特定商取引法、APPI、景品表示法、薬機法など |
| 季節の行事 | 25 | 年間の行事と、デザインへの影響・ビジネス上の注意点 |
| マイクロシーズン | 24 | おおよその日付を含む二十四節気 |
| 色の意味 | 9 | 日本固有の色の連想と HEX 値 |
| プラットフォームのパターン | 30+ | LINE、QR コード、モバイル決済、IME の処理、SNS での共有 |
| アクセシビリティのルール | 20+ | JIS X 8341-3、高齢化、スクリーンリーダー、ふりがな |
| コンテンツのパターン | 15+ | 情報密度、コピー、商品ページ、ローカライズのルール |
対応する慣習
フォームと入力
| 慣習 | 実践方法 |
|---|---|
| 名前の順序 | 姓を先に、名を後に入力します |
| ふりがな | 各名前の入力欄の下に、カタカナの読み欄(セイ/メイ)を設けます |
| 電話番号 | 3つの欄に分けます。形式:XXX-XXXX-XXXX |
| 住所 | 〒郵便番号から都道府県と市区町村を自動入力します。大きな単位から小さな単位の順にします |
| 日付 | 年/月/日の欄を分け、元号の表示は任意とします(令和6年 = 2024) |
| 文字幅 | 入力時に全角の数字と記号を半角に自動変換します |
| 確認 | 最終送信の前に確認画面で内容を確認します |
Typography
| Convention | Practice |
|---|---|
| No italics | Japanese has no italic form. Use bold, color, or size for emphasis |
| Line-height 1.8+ | Kanji density requires more vertical space than Latin text |
| 16px body minimum | Kanji readability breaks below 14px |
| Kinsoku shori | word-break: keep-all + line-break: strict. Never start a line with punctuation |
| Font stacks | Hiragino Sans, Yu Gothic, Meiryo cascade. Noto Sans JP for web fonts |
| Mixed EN/JP | English font first, Japanese fallback: "Inter", "Noto Sans JP", sans-serif |
Layout and structure
| Convention | Practice |
|---|---|
| Information density | Dense layouts are trusted. Sparse reads as hiding information |
| 1280px PC / 375px mobile | Standard artboard sizes with 140-160px side margins |
| Section spacing | 100px between major sections (PC), 60px on mobile |
| Alternating zigzag | Image-left/text-right, then reverse. Standard on Japanese LPs |
| Breadcrumbs | Required on all interior pages |
| Repeat CTAs | Place conversion buttons at multiple scroll points |
Trust and legal
| Convention | Practice |
|---|---|
| 特定商取引法 | Required legal disclosure for ecommerce. Seller info, returns, payment |
| 会社概要 | Company profile page with address, CEO name, capital, founding year |
| Phone in header | Visible phone number signals legitimacy. 0120 toll-free preferred |
| Privacy policy | 個人情報保護方針 required by APPI (amended April 2022) |
| Proof numbers | Specific metrics near hero: 1,247社導入, 業務効率30%改善 |
| Keigo | Four politeness levels mapped to eight business contexts |
Visual and color
| Convention | Practice |
|---|---|
| Red = prosperity | Not danger. Used freely as a primary brand color |
| No red names | Red-on-white for names carries a death association. Use dark text |
| Black + white alone | Funeral association. Add an accent color |
| Bright palettes | Dense, colorful layouts are normal. Dark theme adoption lags the West |
| Manga/anime illustration | Used across industries, including banks and government |
Seasonal
| Convention | Practice |
|---|---|
| 4 seasons, 24 microseasons | Each has distinct color palettes and design motifs |
| Golden Week (Apr 29 - May 5) | Launch blackout. Most businesses closed |
| Obon (Aug 13-16) | Launch blackout. Travel peak |
| Christmas is romantic | Couples celebrate. Families gather at New Year |
| お中元 / お歳暮 | Mid-year and year-end gift seasons. Major ecommerce windows |
Client support
| Client | Support |
|---|---|
| Claude Code | Tools, prompts, resources |
| Cursor | Tools, prompts, resources |
| Windsurf | Tools, prompts, resources |
| VS Code (GitHub Copilot) | Tools, prompts, resources |
| Cline | Tools, prompts, resources |
| Claude Desktop | Tools, prompts, resources |
| Zed | Tools and resources |
| Any stdio MCP client | Tools, prompts, resources |
日本語
日本のWeb UX慣習のためのMCPサーバーです。姓名順、フリガナ、3分割電話番号、〒住所フロー、敬語レベル、タイポグラフィ、信頼シグナル、特定商取引法などの法要件、季節デザインをツール・プロンプト・リソースとして提供します。
Claude Code、Cursor、Windsurf など MCP 対応クライアントで動作します。ローカル動作、APIキー不要。
Disclaimer
This server returns guidance, style rules, and cultural context for building Japanese-facing products. It does not call any brand's API or act on a brand's behalf. Company and service names that appear in examples or recommendations (banks, mobile carriers, payment services, delivery companies, etc.) are referenced as cultural context for users in Japan, not as endorsements or affiliations. All trademarks belong to their respective owners.
License
More MCPs
| MCP | What it does |
|---|---|
| rippr | YouTube transcript ripper for humans and AI agents |
| Rakuten | Search Rakuten's marketplace, books, and hotels |
| Xendit | Xendit payment APIs: invoices, disbursements, balances |
Built by Marsel Bait in Tokyo
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。