关于 japan-ux
japan-ux 是面向编码 Agent 的 MCP 服务,用于检查面向日本用户的界面并提供适配建议。它结合基于标准的排版检查,以及表单、文案、信任要素、法律信息和季节设计规范。
主要功能
- 01按 JLReq/JIS 引用审查 CSS 和标记
- 02生成并验证日文表单
- 03按业务场景建议敬语
- 04评估日本市场适配度并审查 UX
- 05检查排版与季节设计
适用场景
- 01发布前审查面向日本的页面
- 02创建日文注册表单
- 03按业务场景调整英文 UI 文案
- 04检查 CSS 中的日文排版
MCP 相关
向 MCP 客户端提供用于日文 UI 与 UX 工作的工具、提示词和参考资源。它在本地运行,无需 API 密钥。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
11收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| css | string | 是 | 要根据日本 UI 标准审查的 CSS 内容。 |
| markup | string | 否 | 可选的 HTML/JSX markup,用于提供上下文(例如检测图片上的文字)。 |
| context | enum | 否 | 推荐字体栈的设计上下文。corporate | editorial | casual | luxury |
详细介绍
japan-ux-mcp
日本设计 — 为 AI 编码 Agent 提供 UI + UX 正确性保障。 一个前端校验器:将真实 CSS/标记交给它,它会根据日本标准评估 UI,涵盖排版(kinsoku、行高、字体)、色彩象征意义、字体性能,并提供 W3C JLReq / JIS X 4051 引用和修复建议。还包括完整的 UX 层:表单(姓名/假名)、敬语、信任标志、法律要求和季节性设计。
主力工具:review_jp_ui — 前端正确性校验器(发布到日本市场前,可用于任何 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 | 输出日式表单标记:姓/名顺序、假名、〒邮政编码自动填充、三段式电话、年月日日期。 |
validate_jp_form | 根据日本惯例为表单评分(0-100),并列出问题、严重程度和代码修复建议。 |
generate_jp_placeholder | 返回测试数据:汉字/片假名/罗马字姓名、真实邮政编码、格式化电话号码、年号日期。 |
suggest_keigo_level | 根据指定的业务场景,将英文 UI 文本转换为恰当敬语程度的日语。 |
score_japan_readiness | 从五个类别评估页面:表单、文案、信任标志、排版、文化适配度。 |
transform_for_japan | 将西式标记改写为适用于日本的标记,并提供改写前后评分及逐项修改说明。 |
check_jp_typography | 检查 CSS 中的日文排版:字体栈、行高、禁则处理、字号、palt。 |
get_seasonal_context | 返回当前季节、正在进行的活动、24 个微型季节(二十四节気)以及发布禁行时段。 |
audit_japan_ux | 从七个类别进行审查(布局、排版、视觉、导航、信任、内容、移动端),并给出字母等级。 |
design_direction_for_japan | 根据品牌类型、受众和行业,生成针对日本市场的设计简报。 |
提示词
| 提示词 | 描述 |
|---|---|
japan_form | 引导用户逐步构建日文表单。 |
japan_audit | 审核粘贴的标记代码,检查日本用户体验问题。 |
japan_transform | 转换西式标记代码,并提供转换前后的评分。 |
japan_testdata | 为原型生成日文测试数据。 |
japan_keigo | 返回符合适当礼貌程度的界面文本。 |
japan_score | 根据页面描述评估其面向日本市场的准备情况。 |
japan_typography | 检查 CSS 中的日文排版问题。 |
japan_seasonal | 返回特定月份的季节设计背景。 |
japan_full_audit | 执行涵盖七个类别的完整日文用户体验审核。 |
japan_design_direction | 生成适用于日本市场的视觉设计方向。 |
资源
| 资源 | 内容 |
|---|---|
keigo-guide | 涵盖八种商务场景的四个礼貌等级,以及 30 多种界面文案模式。 |
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 电话、Navi Dial |
| 年号 | 5 | 令和至明治各年号及起止日期 |
| 敬语模式 | 30 | 涵盖 9 种元素类型、4 个礼貌等级的界面文本 |
| 字符宽度规则 | 6 | 按字段类型进行全角/半角验证 |
| 布局规则 | 28 | 网格、间距、密度、响应式和结构模式 |
| 排版规则 | 24 | 字体栈、字号、行高、换行和渲染 |
| 字体栈 | 7 | 系统、网页、衬线,以及现代/优雅/圆润/企业风格混合字体 |
| 视觉规则 | 21 | 色彩含义、图像、图标、阴影和圆角 |
| 导航规则 | 16 | 页眉、页脚、菜单、搜索、面包屑、分页 |
| 信任信号 | 20 | 公司信息、社会认同、认证、联系方式 |
| 法律要求 | 10 | 特定商取引法、APPI、景品表示法、药机法等 |
| 季节性活动 | 25 | 全年活动及其设计影响和业务说明 |
| 微季节 | 24 | 二十四节气及其大致日期 |
| 色彩含义 | 9 | 日本特有的颜色联想及其十六进制值 |
| 平台模式 | 30+ | LINE、二维码、移动支付、IME 处理、社交分享 |
| 无障碍规则 | 20+ | JIS X 8341-3、老龄化人口、屏幕阅读器、注音假名 |
| 内容模式 | 15+ | 内容密度、文案、产品页面、本地化规则 |
涵盖的规范
表单与输入
| 规范 | 做法 |
|---|---|
| 姓名顺序 | 姓在前,名在后 |
| 注音假名 | 在每个姓名输入框下方设置片假名读音字段(セイ/メイ) |
| 电话 | 拆分为三个独立字段。格式:XXX-XXXX-XXXX |
| 地址 | 〒邮政编码自动填入都道府县和市区町村。按从大到小的顺序填写 |
| 日期 | 年/月/日分别输入,并可选择显示年号(令和6年 = 2024) |
| 字符宽度 | 输入时自动将全角数字和符号转换为半角 |
| 确认 | 最终提交前显示确认画面 |
字体排版
| 规范 | 做法 |
|---|---|
| 不使用斜体 | 日语没有斜体形式。使用粗体、颜色或字号强调 |
| 行高 1.8+ | 汉字密度较高,需要比拉丁文本更多的垂直空间 |
| 正文字号至少 16px | 字号低于 14px 时,汉字可读性会下降 |
| 禁则处理 | word-break: keep-all + line-break: strict。行首绝不使用标点 |
| 字体栈 | 依次使用 Hiragino Sans、Yu Gothic、Meiryo。网页字体使用 Noto Sans JP |
| 英日混排 | 英文字体优先,日文字体作为后备:"Inter", "Noto Sans JP", sans-serif |
布局与结构
| 规范 | 做法 |
|---|---|
| 信息密度 | 用户信任信息密集的布局。稀疏的布局会让人觉得信息有所隐瞒 |
| 1280px PC / 375px 手机 | 标准画板尺寸,左右边距为 140-160px |
| 区块间距 | 主要区块之间间隔 100px(PC),手机端为 60px |
| 交替锯齿布局 | 图片左、文字右,然后反过来。这是日本 LP 的标准布局 |
| 面包屑导航 | 所有内页都必须设置 |
| 重复设置 CTA | 在多个滚动位置放置转化按钮 |
信任与法律
| 规范 | 做法 |
|---|---|
| 特定商取引法 | 电子商务必须披露的法律信息。包括卖家信息、退货和付款 |
| 公司简介 | 公司资料页面,包括地址、CEO 姓名、资本金和成立年份 |
| 页眉显示电话 | 显示电话号码可传递可信度。优先使用 0120 免费电话 |
| 隐私政策 | APPI(2022 年 4 月修订)要求制定个人信息保护方针 |
| 实绩数据 | 在首屏附近展示具体数据:1,247 社采用、工作效率提升 30% |
| 敬语 | 将四种礼貌等级对应到八种商务场景 |
视觉与色彩
| 规范 | 做法 |
|---|---|
| 红色 = 繁荣 | 不代表危险。可自由用作主品牌色 |
| 姓名不用红色 | 白底红字的姓名会让人联想到死亡。使用深色文字 |
| 仅使用黑白 | 会让人联想到葬礼。应添加强调色 |
| 明亮的配色 | 密集、多彩的布局很常见。深色主题的普及落后于西方 |
| 漫画/动画插画 | 各行各业都会使用,包括银行和政府机构 |
季节性
| 规范 | 做法 |
|---|---|
| 四季、二十四节气 | 每个时节都有独特的配色和设计元素 |
| 黄金周(4 月 29 日 - 5 月 5 日) | 避免上线。大多数企业都会休息 |
| 盂兰盆节(8 月 13-16 日) | 避免上线。这是旅游旺季 |
| 圣诞节具有浪漫色彩 | 情侣庆祝圣诞节,家人则在新年团聚 |
| お中元 / お歳暮 | 年中和年末的送礼时节,也是电商的重要销售窗口 |
客户端支持
| 客户端 | 支持内容 |
|---|---|
| Claude Code | 工具、提示词、资源 |
| Cursor | 工具、提示词、资源 |
| Windsurf | 工具、提示词、资源 |
| VS Code (GitHub Copilot) | 工具、提示词、资源 |
| Cline | 工具、提示词、资源 |
| Claude Desktop | 工具、提示词、资源 |
| Zed | 工具和资源 |
| 任意 stdio MCP 客户端 | 工具、提示词、资源 |
日本語
面向日本市场的 Web UX 惯例 MCP 服务。提供姓名顺序、片假名标注、三段式电话号码、邮政编码地址填写流程、敬语等级、字体排版、信任信号、特定商取引法等法律要求,以及季节性设计等工具、提示词和资源。
可与 Claude Code、Cursor、Windsurf 等支持 MCP 的客户端配合使用。本地运行,无需 API 密钥。
免责声明
此服务提供用于构建面向日本用户的产品的指南、样式规则和文化背景信息。它不会调用任何品牌的 API,也不会代表任何品牌行事。示例或建议中提及的公司和服务名称(银行、移动运营商、支付服务、配送公司等)仅作为面向日本用户的文化背景信息,不构成背书或关联。所有商标均归其各自所有者所有。
许可证
更多 MCP
| MCP | 功能 |
|---|---|
| rippr | 为人类和 AI Agent 提供的 YouTube 字幕提取工具 |
| Rakuten | 搜索 Rakuten 的商城、图书和酒店 |
| Xendit | Xendit 支付 API:发票、付款、余额 |
由 Marsel Bait 在东京打造
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。