# io.github.mrslbt/japan-ux (npm · japan-ux-mcp)

Japanese UI + UX correctness for AI coding agents — typography, forms, keigo, JLReq checks.

- Trust score: 70/100 (medium)
- Change this week: +17
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `japan-ux-mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/mrslbt-japan-ux/japan-ux-mcp.md), [page](https://verifymcp.io/servers/mrslbt-japan-ux/japan-ux-mcp)

## Channel facts

- Registry: `npm`
- Package: `japan-ux-mcp`
- Version: `2.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 16 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2095 tokens (~104/item across 20 items; 11 tools + 9 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add mrslbt-japan-ux -- npx -y japan-ux-mcp
```

### Codex

```bash
codex mcp add mrslbt-japan-ux -- npx -y japan-ux-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mrslbt-japan-ux": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "japan-ux-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add mrslbt-japan-ux --command npx --arg -y --arg japan-ux-mcp
```

### Hermes

```yaml
mcp_servers:
  mrslbt-japan-ux:
    command: "npx"
    args: ["-y", "japan-ux-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "mrslbt-japan-ux": {
      "command": "npx",
      "args": [
        "-y",
        "japan-ux-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 70, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: MIT
- [functional] Package version: 2.0.0 → 2.1.0

### 2026-07-31 (score 26, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 24, −29)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified

### 2026-07-27 (score 53)

First indexed and scored.

## MCP tools (11)

### `review_jp_ui` (~138 tokens)

Review JP UI

Review CSS/markup against the Japanese UI standard (typography, colour, font performance) and return a pass/needs_work/fail verdict with violations, JLReq/JIS citations, and fixes. The front-end correctness enforcer — run on any UI (including Western-built) before shipping to Japan; call transform_for_japan to auto-apply form/copy fixes.

Input parameters:

- `context` (string): Design context for the recommended font stack.
- `css` (string, required): CSS content to review against the Japanese UI standard.
- `markup` (string): Optional HTML/JSX markup for context (e.g. text-on-photo detection).

### `generate_jp_form` (~143 tokens)

Generate JP Form

Generate culturally correct Japanese form markup with proper field order (姓→名), furigana, 3-field phone, 〒 postal address, 年月日 dates, and context-appropriate keigo. Use this when building any form for a Japanese audience.

Input parameters:

- `context` (string, required): Business context — determines keigo politeness level
- `fields` (array, required): Fields to include in the form
- `format` (string): Output format
- `include_labels` (boolean): Include field labels
- `include_validation` (boolean): Include validation patterns
- `language` (string): Label language
- `type` (string, required): Type of form to generate

### `validate_jp_form` (~100 tokens)

Validate JP Form

Audit an existing form against Japanese UX conventions. Checks for: name field order (姓/名), furigana, 3-field phone, postal code auto-fill, keigo-appropriate button text, full-width character handling. Returns score (0-100), issues with fixes, and what passed.

Input parameters:

- `context` (string, required): Business context for keigo expectations
- `form_markup` (string, required): HTML/JSX form markup to audit

### `generate_jp_placeholder` (~130 tokens)

Generate JP Placeholder Data

Generate realistic Japanese test data for prototypes and development. Returns names (kanji + katakana furigana + romaji), addresses (real postal codes and prefectures), phone numbers (correct 3-field format), company names, and dates (both Gregorian and Japanese era format like 平成4年3月15日).

Input parameters:

- `age_range` (string): Age range like "20-40" for date_of_birth generation
- `count` (number): Number of records to generate
- `fields` (array, required): Data fields to include
- `gender` (string): Gender for name generation

### `suggest_keigo_level` (~127 tokens)

Suggest Keigo Level

Suggest appropriately polite Japanese UI text based on context. Maps business context to keigo level (casual → very_formal) and returns the right Japanese translation for buttons, error messages, empty states, confirmations, and more. Includes alternatives for different formality levels.

Input parameters:

- `context` (string, required): Business context — determines keigo level
- `text` (string, required): English UI text to translate (e.g. 'Invalid email address', 'Submit', 'No results found')
- `tone` (string): Optional tone override
- `ui_element` (string, required): Type of UI element

### `score_japan_readiness` (~155 tokens)

Score Japan Readiness

Score any page or component for Japan-readiness on a 0-100 scale. Analyzes 5 categories: forms (name order, furigana, phone, postal), copy (keigo, Japanese text, placeholders), trust (特定商取引法, phone number, company info), typography (font, size, line-height), and cultural (seasonal awareness, imagery). Returns breakdown with issues and quick wins per category.

Input parameters:

- `context` (string, required): Business context
- `description` (string): Description of the page/component for additional context
- `include_suggestions` (boolean): Include priority fix suggestions with impact estimates
- `markup` (string, required): HTML/JSX markup to analyze

### `transform_for_japan` (~138 tokens)

Transform for Japan

Transform Western markup into Japan-ready markup. Automatically fixes: name field order (firstName/lastName → 姓/名), adds furigana, splits phone into 3 fields, restructures address to 〒 postal format, translates buttons with appropriate keigo, replaces Western placeholder data with Japanese examples. Shows before/after scores and explains every change.

Input parameters:

- `context` (string, required): Business context — determines keigo level and conventions
- `format` (string): Output format
- `markup` (string, required): Western HTML/JSX markup to transform
- `preserve_styling` (boolean): Preserve existing CSS classes and styles

### `check_jp_typography` (~165 tokens)

Check JP Typography

Audit CSS and markup for Japanese typography issues. Checks: font stacks (Noto Sans JP, Hiragino, Yu Gothic), line-height (1.7-2.0 for Japanese body text), font sizes (14px body minimum, 12px captions floor), kinsoku shori (line-break: strict), text-on-photo overlays, font-feature-settings 'palt' on headings, font-synthesis, and more. Returns score, issues, and a recommended font stack for your context.

Input parameters:

- `context` (string): Design context for font stack recommendation
- `css` (string, required): CSS content to audit for Japanese typography issues
- `markup` (string): Optional HTML/JSX markup for additional context (background images, text-on-photo detection)

### `get_seasonal_context` (~115 tokens)

Get Seasonal Context

Get the current Japanese seasonal context for design decisions. Returns: current season with traditional colors, active events (正月, 花見, お盆, etc.), upcoming events, the current microseason (二十四節気), recommended design colors, and warnings (e.g., do not launch during Golden Week). Covers all 24 Japanese microseasons and 24+ major events.

Input parameters:

- `day` (number): Day of month (defaults to 15)
- `month` (number, required): Month (1-12)

### `audit_japan_ux` (~183 tokens)

Audit Japan UX

Comprehensive Japanese UX audit covering 7 categories: layout (density, breadcrumbs, CTA placement), typography (fonts, line-height, kinsoku shori), visual (color meanings, red-name taboo, dark theme), navigation (phone number, footer links, hamburger rules), trust (会社概要, case studies, proof numbers, legal links), content (Japanese text, FAQ, pricing tables), and mobile (viewport, tel: links, touch targets). Returns letter grade (A-F), category scores, and prioritized fixes.

Input parameters:

- `css` (string): CSS content for typography and visual checks
- `markup` (string, required): HTML/JSX markup to audit
- `site_type` (string, required): Type of site being audited
- `target_audience` (string): Target audience description
- `url_description` (string): Description of the page for additional context

### `design_direction_for_japan` (~154 tokens)

Design Direction for Japan

Generate a Japan-specific visual direction for a website or interface. Takes a loose brand type, audience, and industry, then returns a practical design brief covering visual direction, information density, color palette, typography, imagery style, CTA style, trust layout, and section priorities.

Input parameters:

- `audience` (string, required): Target audience such as 'business buyers', 'families', 'seniors', 'domestic travelers'
- `brand_type` (string, required): Brand expression such as 'modern minimal', 'premium', 'friendly', 'traditional craft'
- `industry` (string, required): Industry or site type such as 'B2B SaaS', 'clinic', 'luxury ryokan', 'ecommerce', 'corporate'

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/mrslbt-japan-ux/japan-ux-mcp#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 70
- 2026-08-01: 26
- 2026-07-31: 26
- 2026-07-30: 24
- 2026-07-28: 53
- 2026-07-27: 53

## Links

- npm package: https://www.npmjs.com/package/japan-ux-mcp
- Socket report: https://socket.dev/npm/package/japan-ux-mcp
- Repository: https://github.com/mrslbt/japan-ux-mcp
- Changelog RSS feed: https://verifymcp.io/servers/mrslbt-japan-ux/japan-ux-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/mrslbt-japan-ux/japan-ux-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/mrslbt-japan-ux/japan-ux-mcp