Broadfast用户体验编写器MCP
基于AI的用户体验写作助手 模型上下文协议（MCP）生成品牌微拷贝，审核Figma设计，并推动本地化——所有这些都遵循Breadfast官方的2025年语音和音调指南。
它的作用
| 工具 | 说明 |
|---|---|
generate_content | 生成用户体验副本 英语、阿拉伯语或两者兼有 （按钮、标题、错误、标签……）2-3个选项+推理 |
audit_figma_copy | Figma页面中的批量审核文本，包含合规评分（0-10）和建议（支持阿拉伯语验证） |
apply_suggestions | 将批准的审计修复应用回Figma |
load_prd | 加载PRD以通知上下文内容生成 |
analyze_figma | 分析Figma文件以识别文本节点 |
update_figma | 将生成的副本应用于Figma文本节点 |
push_to_phrase | 将最终版本推送到Phrase.com进行本地化 |
add_content_example | 保存好的例子以改进未来的建议 |
快速开始
1.安装
git clone https://github.com/ahmedelmaghraby89/breadfast-ux-writer.git
cd breadfast-ux-writer
npm install
npm run build2.配置
添加到您的Claude Desktop配置中：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"breadfast-ux-writer": {
"command": "node",
"args": ["/absolute/path/to/breadfast-ux-writer/build/index.js"],
"env": {
"FIGMA_ACCESS_TOKEN": "YOUR_FIGMA_TOKEN",
"PHRASE_API_TOKEN": "YOUR_PHRASE_TOKEN",
"PHRASE_PROJECT_ID": "YOUR_PROJECT_ID"
}
}
}
}注： Figma和Phrase标记是可选的。核心内容生成在没有它们的情况下也能正常工作。
3.重新启动克劳德桌面
关闭并重新打开Claude Desktop以加载MCP服务器。
4.开始使用它
仅限英语：
"Generate a button label for submitting a gift referral"输出：
Primary: Send gift
Alternatives:
1. Submit
2. Send now
Reasoning: "Send gift" follows Breadfast guidelines:
- Action verb first ("Send")
- Sentence case
- 2 words (within 1-2 word guideline)
- Matches production style双语（英语+阿拉伯语）：
"Generate a button label for submitting a gift referral in both English and Arabic"输出：
English:
Primary: Send gift
Alternatives: 1. Submit, 2. Send now
Arabic:
Primary: أرسل الهدية
Alternatives: 1. إرسال, 2. ابعت دلوقتي
Reasoning: Follows Breadfast bilingual guidelines with appropriate formality levels用法示例
生成副本
英语：
Generate a heading for the checkout screen
Generate an error message for invalid phone number
Generate placeholder text for a search input阿拉伯语：
Generate an Arabic heading for the checkout screen
Generate an Arabic error message for invalid phone number双语的：
Generate a heading for the checkout screen in both English and Arabic
Generate an error message for invalid phone number in both languages
Generate a promotional notification in English and Arabic加载PRD上下文
Load the PRD from /path/to/feature-spec.md
Generate copy for the main CTA based on the PRD审计图副本
Audit the copy in this Figma file: https://figma.com/file/abc123
Apply all suggestions with score below 5推动本地化
Push the approved copy to Phrase with tags ["checkout", "v2"]里面有什么
语音和音调指南
服务器自动加载Breadfast的完整 双语 用户体验写作指南：
英语指南：
- 性格特征： 富有同情心、自信、雄心勃勃、创新、谦逊、负责
- 色调属性： 简洁明了、透明、真实、平易近人、友好
- 语法和风格： 主动语态、句子大小写、标点规则、数字/日期/货币格式
- 组件规则： 按钮、标题、错误、空状态、工具提示、模态等
- 50+生产示例： 来自Breadfast直播产品的真实副本
阿拉伯指南（Arabic Guidelines）：
- 形式映射： 埃及阿拉伯语（营销/通知），混合MSA埃及语（按钮/交易），现代标准阿拉伯语（错误/法律）
- 语法和风格： 阿拉伯-印度数字，无tashkeel，句子大小写，标点规则
- 组件规则： 长度指南（+20-25%），特定组件的正式程度
- 单词选择： 术语、文化敏感性、常用短语
- 50+生产示例： 正式映射后的真实阿拉伯语副本
项目结构
breadfast-ux-writer/
├── src/ # TypeScript source
│ ├── index.ts # MCP server entry point
│ ├── state.ts # Session state management
│ ├── types/ # Type definitions
│ ├── utils/ # Guidelines loader
│ └── tools/ # Tool implementations
│ ├── content.ts # Content generation
│ ├── audit.ts # Copy auditing
│ ├── audit-confirm.ts # Apply suggestions
│ ├── figma.ts # Figma integration
│ ├── prd.ts # PRD loading
│ ├── phrase.ts # Phrase.com integration
│ └── examples.ts # Learning system
├── guidelines/ # Voice & Tone guidelines
│ ├── principles.md # English principles
│ ├── tone-attributes.md
│ ├── grammar-and-style.md
│ ├── components.md
│ ├── word-choices.md
│ ├── examples.md
│ ├── content-examples.json
│ └── arabic/ # Arabic guidelines
│ ├── principles-ar.md
│ ├── grammar-ar.md
│ ├── components-ar.md
│ ├── tone-attributes-ar.md
│ ├── word-choices-ar.md
│ └── examples-ar.md
├── docs/ # Documentation
└── test-data/ # Test files集成
Figma（通过桌面桥）
Phrase.com
将批准的副本直接推送到Phrase.com进行翻译。集 PHRASE_API_TOKEN 和 PHRASE_PROJECT_ID 在您的环境中。
发展
npm run build # Compile TypeScript
npm run dev # Watch mode
npm run typecheck # Type check only
npm run clean # Remove build
npm run rebuild # Clean + build更新
要获取最新版本：
cd breadfast-ux-writer
git pull
npm install
npm run build然后重新启动Claude Desktop。
文档
学分
基于以下内容的语音和音调指南 Breadfast用户体验写作指南2025 作者：亚斯敏·阿卜杜勒奈姆。
许可证
麻省理工学院