Japan Ux

japan-ux-mcp

Japan Design — UI + UX correctness for AI coding agents. A front-end *enforcer*: point it at real CSS/markup and it scores your UI against the Japanese standard — typography (kinsoku, line-height, fonts), colour symbolism, font performance — with W3C JLReq / JIS X 4051 citations and fixes. Plus the full UX layer: forms (姓名/furigana), keigo, trust signals, legal, and seasonal design.

Lead tool: `review_jp_ui` — the front-end correctness enforcer (run it on any UI, including Western-built, before shipping to Japan).

Eleven tools, ten prompts, nine resources. Runs locally, no API keys. Findings are labelled spec (JLReq/JIS) vs convention (documented JP web practice) so authority is never overstated.

Install

claude mcp add japan-ux -- npx -y japan-ux-mcp

JSON config

The server config is the same across clients; only the file path differs.

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 extension)

Open Cline's MCP settings panel and add:

{

"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"] } } }

Config path:

• 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"] } } } }

From source

git clone https://github.com/mrslbt/japan-ux-mcp.git

cd japan-ux-mcp npm install && npm run build

Point the client config at the built entry:

{ "command": "node", "args": ["/absolute/path/to/japan-ux-mcp/dist/index.js"] }

Tools

Prompts

Resources

Example prompts

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:

Submit

Transform this form for the Japanese market (fintech context):

First Name Last Name Phone Address Submit

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.

Bundled data

All data ships with the package. No external APIs, no keys, no network calls.

Conventions covered

Forms and input

Typography

Layout and structure

Trust and legal

Visual and color

Seasonal

| 4 seasons, 24 microseasons | Each has distinct color palettes and desig