Breadfast Ux Writer

Broadfast用户体验编写器MCP

基于AI的用户体验写作助手 模型上下文协议（MCP）生成品牌微拷贝，审核Figma设计，并推动本地化——所有这些都遵循Breadfast官方的2025年语音和音调指南。

它的作用

快速开始

1.安装

git clone https://github.com/ahmedelmaghraby89/breadfast-ux-writer.git
cd breadfast-ux-writer
npm install
npm run build

2.配置

添加到您的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 作者：亚斯敏·阿卜杜勒奈姆。

许可证

麻省理工学院