mcpField
J
japan-ux

japan-ux

本地服务
github.com/mrslbt开发工具011 周前更新

关于 japan-ux

japan-ux 是面向编码 Agent 的 MCP 服务,用于检查面向日本用户的界面并提供适配建议。它结合基于标准的排版检查,以及表单、文案、信任要素、法律信息和季节设计规范。

主要功能

  1. 01按 JLReq/JIS 引用审查 CSS 和标记
  2. 02生成并验证日文表单
  3. 03按业务场景建议敬语
  4. 04评估日本市场适配度并审查 UX
  5. 05检查排版与季节设计

适用场景

  1. 01发布前审查面向日本的页面
  2. 02创建日文注册表单
  3. 03按业务场景调整英文 UI 文案
  4. 04检查 CSS 中的日文排版

MCP 相关

向 MCP 客户端提供用于日文 UI 与 UX 工作的工具、提示词和参考资源。它在本地运行,无需 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

日本设计 — 为 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-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代码、名称、假名、罗马字、地区
姓名10050 个姓氏 + 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,也不会代表任何品牌行事。示例或建议中提及的公司和服务名称(银行、移动运营商、支付服务、配送公司等)仅作为面向日本用户的文化背景信息,不构成背书或关联。所有商标均归其各自所有者所有。

许可证

MIT


更多 MCP

MCP功能
rippr为人类和 AI Agent 提供的 YouTube 字幕提取工具
Rakuten搜索 Rakuten 的商城、图书和酒店
XenditXendit 支付 API:发票、付款、余额

由 Marsel Bait 在东京打造

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。