安裝
內容詳情
安裝
{
"mcpServers": {
"japan-ux": { "command": "npx", "args": ["-y", "japan-ux-mcp"] }
}
}🗾 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 在東京打造 🌸
替代品








VIP會員