mcpField
J
japan-ux

japan-ux

ローカル
github.com/mrslbt開発ツール011 週間前に更新

japan-ux について

japan-uxは、コーディングエージェント向けに日本向けインターフェースを検査し、UI・UXの調整を支援するMCPサーバーです。規格に基づくタイポグラフィ検査に加え、フォーム、表現、信頼性、法的情報、季節デザインの慣習を扱います。

主な機能

  1. 01JLReq/JISの引用付きCSS・マークアップ検査
  2. 02日本語フォームの生成と検証
  3. 03ビジネス状況に応じた敬語の提案
  4. 04日本向け適合度の評価とUX監査
  5. 05タイポグラフィと季節性の確認

活用シーン

  1. 01日本向けページの公開前レビュー
  2. 02日本語の登録フォーム作成
  3. 03ビジネス状況に応じた英語UI文言の調整
  4. 04CSSの日本語タイポグラフィ検査

MCP 対応

日本語UI・UX作業向けのツール、プロンプト、参照リソースをMCPクライアントに提供します。APIキー不要でローカル動作します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"mrslbt-japan-ux": {
"command": "npx",
"args": [
"-y",
"japan-ux-mcp"
]
}
}
}
起動コマンドnpx -y japan-ux-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmjapan-ux-mcp2.1.1

ツール

11

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
cssstringはい日本の UI 標準に照らしてレビューする CSS の内容。
markupstringいいえコンテキスト用の任意の HTML/JSX markup(例:写真上のテキスト検出)。
contextenumいいえ推奨フォントスタックのデザインコンテキスト。corporate | editorial | casual | luxury

詳細

japan-ux-mcp

npm version npm downloads MCP Badge japan-ux-mcp MCP server License: MIT

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_readiness5 つのカテゴリー(フォーム、コピー、信頼性を高める要素、タイポグラフィ、文化的適合性)にわたってページを評価します。
transform_for_japan西洋のマークアップを日本向けのマークアップに書き換え、変更前後のスコアと変更ごとの説明を提示します。
check_jp_typography日本語のタイポグラフィに関する CSS を監査します:フォントスタック、行の高さ、禁則処理、サイズ、palt。
get_seasonal_context現在の季節、開催中のイベント、24 のマイクロシーズン(二十四節気)、ローンチを避けるべき期間を返します。
audit_japan_ux7 つのカテゴリー(レイアウト、タイポグラフィ、ビジュアル、ナビゲーション、信頼性、コンテンツ、モバイル)を監査し、レターグレードで評価します。
design_direction_for_japanブランドの種類、対象者、業界に基づき、日本向けのデザインブリーフを作成します。

プロンプト

プロンプト説明
japan_form日本語フォームの作成手順を案内します。
japan_audit貼り付けられたマークアップを監査し、日本語 UX の問題を確認します。
japan_transform変換前後のスコアを付けながら、西洋風のマークアップを変換します。
japan_testdataプロトタイプ用の日本語テストデータを生成します。
japan_keigo適切な丁寧さのレベルで UI テキストを返します。
japan_scoreページの説明を、日本市場への対応度に基づいて採点します。
japan_typographyCSS に日本語組版の問題がないか確認します。
japan_seasonal特定の月に合わせた季節のデザインコンテキストを返します。
japan_full_audit日本語 UX を7つのカテゴリーで全面的に監査します。
japan_design_direction日本市場向けのビジュアルデザイン方針を生成します。

リソース

リソース内容
keigo-guide8つのビジネスコンテキストにおける4段階の丁寧さ、30種類以上の UI コピーのパターン。
form-checklist公開前のレビュー用、日本語フォームの慣習。
phone-formats携帯電話、固定電話、フリーダイヤル、IP 電話のパターンと項目分割のルール。
era-calendar令和から明治までの期間と換算式。
typography-guideフォントスタック、文字サイズのスケール、行の高さ、禁則処理、CSS の提案。
seasonal-calendar24の行事、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令和から明治までの開始日と終了日
敬語のパターン309種類の要素における、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
ConventionPractice
No italicsJapanese 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 minimumKanji readability breaks below 14px
Kinsoku shoriword-break: keep-all + line-break: strict. Never start a line with punctuation
Font stacksHiragino Sans, Yu Gothic, Meiryo cascade. Noto Sans JP for web fonts
Mixed EN/JPEnglish font first, Japanese fallback: "Inter", "Noto Sans JP", sans-serif
Layout and structure
ConventionPractice
Information densityDense layouts are trusted. Sparse reads as hiding information
1280px PC / 375px mobileStandard artboard sizes with 140-160px side margins
Section spacing100px between major sections (PC), 60px on mobile
Alternating zigzagImage-left/text-right, then reverse. Standard on Japanese LPs
BreadcrumbsRequired on all interior pages
Repeat CTAsPlace conversion buttons at multiple scroll points
Trust and legal
ConventionPractice
特定商取引法Required legal disclosure for ecommerce. Seller info, returns, payment
会社概要Company profile page with address, CEO name, capital, founding year
Phone in headerVisible phone number signals legitimacy. 0120 toll-free preferred
Privacy policy個人情報保護方針 required by APPI (amended April 2022)
Proof numbersSpecific metrics near hero: 1,247社導入, 業務効率30%改善
KeigoFour politeness levels mapped to eight business contexts
Visual and color
ConventionPractice
Red = prosperityNot danger. Used freely as a primary brand color
No red namesRed-on-white for names carries a death association. Use dark text
Black + white aloneFuneral association. Add an accent color
Bright palettesDense, colorful layouts are normal. Dark theme adoption lags the West
Manga/anime illustrationUsed across industries, including banks and government
Seasonal
ConventionPractice
4 seasons, 24 microseasonsEach 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 romanticCouples celebrate. Families gather at New Year
お中元 / お歳暮Mid-year and year-end gift seasons. Major ecommerce windows

Client support

ClientSupport
Claude CodeTools, prompts, resources
CursorTools, prompts, resources
WindsurfTools, prompts, resources
VS Code (GitHub Copilot)Tools, prompts, resources
ClineTools, prompts, resources
Claude DesktopTools, prompts, resources
ZedTools and resources
Any stdio MCP clientTools, 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

MIT


More MCPs

MCPWhat it does
ripprYouTube transcript ripper for humans and AI agents
RakutenSearch Rakuten's marketplace, books, and hotels
XenditXendit payment APIs: invoices, disbursements, balances

Built by Marsel Bait in Tokyo

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。