🗾 japan-ux-mcp
日本设计 —— 面向 AI 编程代理的 UI + UX 正确性校验。 一个前端**「执法者」**:将它指向真实的 CSS/标记,它会依据日本标准为你的 UI 打分 —— 排版(禁则处理 kinsoku、行高、字体)、色彩象征、字体性能 —— 并附上 W3C JLReq / JIS X 4051 引用与修复建议。此外还涵盖完整的 UX 层面:表单(姓名/假名 furigana)、敬语(keigo)、信任信号、法律合规与季节性设计。
主打工具:review_jp_ui —— 前端正确性执法者(在任何 UI 上线日本之前运行它,包括西式风格的 UI)。
🧩 十一个工具、十个提示词、九个资源。本地运行,无需 API 密钥。
结果会标注为 spec(JLReq/JIS 规范)还是 convention(有据可查的日本 Web 惯例),从而绝不夸大权威性。
📦 安装
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 |
输出日文表单标记:姓/名顺序、假名(furigana)、〒 邮编自动填充、3 段式电话、年月日日期。 |
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 |
审计粘贴的标记中的日本 UX 问题。 |
japan_transform |
转换西式标记,并给出前后评分。 |
japan_testdata |
为原型生成日文测试数据。 |
japan_keigo |
返回恰当敬语级别的 UI 文案。 |
japan_score |
根据页面描述为其日本就绪度打分。 |
japan_typography |
检查 CSS 中的日文排版问题。 |
japan_seasonal |
返回指定月份的当季设计背景。 |
japan_full_audit |
运行完整的七大类日本 UX 审计。 |
japan_design_direction |
生成针对日本的视觉方向。 |
📚 资源
| 资源 |
内容 |
keigo-guide |
跨八种商务场景的四级敬语,30+ 条 UI 文案范式。 |
form-checklist |
上线前审查用的日文表单惯例清单。 |
phone-formats |
手机、座机、免费电话、IP 电话格式及字段拆分规则。 |
era-calendar |
从令和到明治的年号、日期范围与换算公式。 |
typography-guide |
字体栈、字号级阶、行高、禁则处理、CSS 建议。 |
seasonal-calendar |
24 个活动、24 个微季节、当季配色、上线黑名单日期。 |
trust-checklist |
按站点类型划分的信任信号、法律页面与社交证明。 |
color-guide |
日本配色含义、红名禁忌、视觉设计规则。 |
layout-guide |
栅格、间距、密度、响应式断点、结构模式。 |
💡 示例提示词
为日本 B2B SaaS 产品构建一个注册表单。包含姓名、
邮箱、电话、公司、地址。使用 TSX 与 Tailwind。
为这个表单审查日本惯例:
<form>
<input name="firstName" placeholder="First Name" />
<input name="lastName" placeholder="Last Name" />
<input name="email" />
<input name="phone" />
<button>Submit</button>
</form>
为日本市场转换这个表单(金融科技场景):
<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>
我需要一个银行应用的日文 UI 文案:
- 错误:"Invalid email address"
- 按钮:"Submit application"
- 空状态:"No transactions yet"
- 确认:"Are you sure you want to delete?"
检查这段 CSS 是否存在日文排版问题:
body { font-family: Arial; font-size: 14px; line-height: 1.4; font-style: italic; }
对这个 B2B SaaS 落地页进行日本 UX 审计。Hero 使用英文
标语、功能网格、定价表、页头无电话号码、无
公司信息页、单栏布局。
🗃️ 内置数据
所有数据随包附带。无外部 API、无密钥、无网络请求。
| 数据 |
数量 |
详情 |
| 都道府县 |
47 |
代码、名称、假名、罗马字、地区 |
| 姓名 |
100 |
50 个姓氏 + 50 个名字,含汉字/假名/罗马字 |
| 地址 |
12 |
各大城市的真实邮编 |
| 电话格式 |
6 |
手机、座机、免费电话、IP 电话、Navi Dial |
| 年号 |
5 |
从令和到明治,含起止日期 |
| 敬语范式 |
30 |
跨 4 个敬语级别、9 种元素类型的 UI 文案 |
| 宽度规则 |
6 |
各字段类型的全角/半角校验 |
| 布局规则 |
28 |
栅格、间距、密度、响应式、结构模式 |
| 排版规则 |
24 |
字体栈、字号、行高、换行、渲染 |
| 字体栈 |
7 |
系统、Web、衬线、混合现代/优雅/圆体/企业风 |
| 视觉规则 |
21 |
配色含义、图像、图标、阴影、圆角 |
| 导航规则 |
16 |
页头、页脚、菜单、搜索、面包屑、分页 |
| 信任信号 |
20 |
公司信息、社交证明、认证、联系方式 |
| 法律要求 |
10 |
特定商取引法、APPI、景品表示法、薬機法 等 |
| 季节活动 |
25 |
全年,含设计影响与商务提示 |
| 微季节 |
24 |
二十四節気及其大致日期 |
| 配色含义 |
9 |
日本特有的色彩联想及十六进制值 |
| 平台模式 |
30+ |
LINE、二维码、移动支付、IME 处理、社交分享 |
| 无障碍规则 |
20+ |
JIS X 8341-3、老龄化人口、屏幕阅读器、furigana |
| 内容模式 |
15+ |
密度、文案、商品页、本地化规则 |
📐 涵盖的规范
📝 表单与输入
| 惯例 |
做法 |
| 姓名顺序 |
姓(姓)在前,名(名)在后 |
| 假名(Furigana) |
每个姓名字段下方设片假名读音字段(セイ/メイ) |
| 电话 |
三个独立字段。格式:XXX-XXXX-XXXX |
| 地址 |
〒 邮编自动填充都道府县 + 城市。从大到小排列 |
| 日期 |
独立的 年/月/日 输入,可选年号显示(令和6年 = 2024) |
| 字符宽度 |
输入时自动将全角数字与符号转换为半角 |
| 确认 |
最终提交前的 確認画面 确认页 |
✍️ 排版
| 惯例 |
做法 |
| 不使用斜体 |
日文没有斜体形式。用加粗、颜色或字号来强调 |
| 行高 1.8+ |
汉字密度需要比拉丁文字更多的垂直空间 |
| 正文最小 16px |
低于 14px 时汉字可读性会下降 |
| 禁则处理 |
word-break: keep-all + line-break: strict。行首绝不出现标点 |
| 字体栈 |
Hiragino Sans、Yu Gothic、Meiryo 级联。Web 字体使用 Noto Sans JP |
| 中英混排 |
英文字体在前,日文回退:"Inter", "Noto Sans JP", sans-serif |
🏗️ 布局与结构
| 惯例 |
做法 |
| 信息密度 |
密集布局更受信任。稀疏会被视为隐藏信息 |
| 1280px PC / 375px 移动端 |
标准画板尺寸,两侧留白 140-160px |
| 区块间距 |
大区块之间 100px(PC),移动端 60px |
| 交替之字形 |
图左文右,然后反转。日本落地页的标配 |
| 面包屑 |
所有内页必需 |
| 重复 CTA |
在多个滚动位置放置转化按钮 |
🤝 信任与法律
| 惯例 |
做法 |
| 特定商取引法 |
电商必需的法律披露。卖家信息、退货、支付 |
| 会社概要 |
公司简介页面,含地址、CEO 姓名、资本、成立年份 |
| 页头电话 |
可见的电话号码传递可信度。优先使用 0120 免费电话 |
| 隐私政策 |
APPI 要求的 個人情報保護方針(2022 年 4 月修订) |
| 证明数字 |
首屏附近的明确指标:1,247社導入、業務効率30%改善 |
| 敬语 |
四级敬语对应八种商务场景 |
🎨 视觉与配色
| 惯例 |
做法 |
| 红色 = 繁荣 |
而非危险。可自由用作主品牌色 |
| 姓名不用红色 |
白底红字用于姓名带有死亡联想。请使用深色文字 |
| 仅黑白 |
带有葬礼联想。请加入点缀色 |
| 明亮配色 |
密集、多彩的布局很正常。深色主题的采用落后于西方 |
| 漫画/动画插画 |
跨行业使用,包括银行与政府 |
🍁 季节
| 惯例 |
做法 |
| 4 季、24 微季节 |
各自拥有独特的配色与设计母题 |
| 黄金周(4月29日 - 5月5日) |
上线黑名单。多数企业歇业 |
| 盂兰盆节(8月13-16日) |
上线黑名单。出行高峰 |
| 圣诞是浪漫节日 |
情侣庆祝。家人则在元旦团聚 |
| お中元 / お歳暮 |
年中与年末的送礼季。重要的电商窗口 |
🖥️ 客户端支持
| 客户端 |
支持 |
| Claude Code |
工具、提示词、资源 |
| Cursor |
工具、提示词、资源 |
| Windsurf |
工具、提示词、资源 |
| VS Code (GitHub Copilot) |
工具、提示词、资源 |
| Cline |
工具、提示词、资源 |
| Claude Desktop |
工具、提示词、资源 |
| Zed |
工具与资源 |
| 任意 stdio MCP 客户端 |
工具、提示词、资源 |
🇯🇵 日语简介
一个面向日本 Web UX 惯例的 MCP 服务器。以工具、提示词、资源的形式,提供姓名顺序、假名、3 段式电话号码、〒 地址流程、敬语级别、排版、信任信号、特定商取引法等法律要求,以及季节性设计。
可在 Claude Code、Cursor、Windsurf 等支持 MCP 的客户端中运行。本地运行,无需 API 密钥。
⚠️ 免责声明
本服务器返回的是构建面向日本产品时的指南、风格规则与文化背景。它不会调用任何品牌的 API,也不代表任何品牌行事。示例或建议中出现的公司及服务名称(银行、移动运营商、支付服务、快递公司等)是作为面向日本用户的文化背景引用,而非认可或隶属关系。所有商标均归其各自所有者所有。
📄 许可证
MIT
🔗 更多 MCP
| MCP |
作用 |
| rippr |
面向人类和 AI 代理的 YouTube 转写提取工具 |
| Rakuten |
搜索乐天市场、图书和酒店 |
| Xendit |
Xendit 支付 API:发票、放款、余额 |
由 Marsel Bait 在东京打造 🌸