stylemcp

StyleMCP

为 AI 模型和 Agent 提供可执行的品牌规则。让每条 AI 生成的消息都符合品牌风格。

什么是 StyleMCP？

StyleMCP 可验证并改写 AI 生成的文本，使其符合你的品牌语调。可将它用作：

• REST API - 验证来自任何应用的文本
• MCP 服务 - 直接集成 Claude 和其他 AI Agent
• CLI - 在终端或 CI/CD 中检查文案
• GitHub Action - 在拉取请求中发现不符合品牌风格的文案

快速开始

API

curl -X POST https://stylemcp.com/api/validate \
  -H "Content-Type: application/json" \
  -d '{"text": "Click here to learn more!"}'

响应：

{
  "valid": false,
  "score": 65,
  "violations": [
    {
      "rule": "no-click-here",
      "severity": "error",
      "message": "Avoid 'click here' - describe the destination instead",
      "suggestion": "Learn more about our features"
    }
  ]
}

CLI

# Install
npm install -g stylemcp

# Validate text
stylemcp validate "Click here to learn more"

# Validate file
stylemcp validate src/copy/homepage.json --pack saas

# Rewrite text
stylemcp rewrite "Please utilize our product" --mode aggressive

MCP（Claude Desktop）

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "stylemcp": {
      "command": "npx",
      "args": ["stylemcp"]
    }
  }
}

现在 Claude 可以使用你的品牌规则验证和改写文本。

API 端点

方法	端点	描述
POST	/api/validate	根据品牌规则验证文本
POST	/api/rewrite	改写文本，使其符合品牌语调
POST	/api/validate/batch	验证多段文本
GET	/api/packs	列出可用的风格包
GET	/api/packs/{pack}/voice	获取语调指南
GET	/api/packs/{pack}/ctas	获取 CTA 规则
GET	/api/mcp/sse	MCP SSE 端点
POST	/api/mcp/call	MCP 工具调用

风格包

StyleMCP 使用风格包——用于定义品牌规则的 YAML 文件。

可用的风格包

风格包	适用场景	主要特点
saas	B2B SaaS 产品	专业、清晰、友好的语调
ecommerce	DTC 和零售品牌	友好、注重转化、不使用咄咄逼人的 CTA
healthcare	医疗与健康领域	使用合规语言、不宣称治愈、以人为本
finance	金融科技与银行业	精准、关注风险、不保证收益

示例：saas 风格包

• 词汇：优先使用“use”而非“utilize”，“help”而非“assist”
• 禁用词：“synergy”、“leverage”、“cutting-edge”、“game-changing”
• 应避免的表达：“click here”、“we're sorry for any inconvenience”
• CTA 规则：避免使用“Submit”、“Click here”、“OK”——优先使用“Save”、“Create”、“Sign up”

风格包结构

packs/
  my-brand/
    manifest.yaml      # Pack metadata
    voice.yaml         # Tone, vocabulary, forbidden words
    copy_patterns.yaml # Reusable copy templates
    cta_rules.yaml     # Button/CTA guidelines
    tokens.json        # Design tokens (optional)

创建自己的风格包

# Copy the default pack
cp -r packs/saas packs/my-brand

# Edit the rules
nano packs/my-brand/voice.yaml

# Use your pack
curl -X POST https://stylemcp.com/api/validate \
  -d '{"text": "Your text", "pack": "my-brand"}'

voice.yaml 示例

tone:
  summary: "Friendly, clear, and helpful"
  attributes:
    - name: friendly
      weight: 0.8
    - name: professional
      weight: 0.7

vocabulary:
  rules:
    - preferred: "use"
      avoid: ["utilize", "leverage"]
    - preferred: "help"
      avoid: ["assist", "facilitate"]

  forbidden:
    - "synergy"
    - "paradigm shift"
    - "game-changing"

doNot:
  - pattern: "click here"
    reason: "Poor accessibility"
    suggestion: "Describe the destination"
    severity: error

  - pattern: "\\b(obviously|simply|just)\\b"
    isRegex: true
    reason: "Can make users feel stupid"
    severity: warning

自托管

Docker

# Clone the repo
git clone https://github.com/3DUNLMTD/stylemcp.git
cd stylemcp

# Set up environment
echo "STYLEMCP_API_KEY=$(openssl rand -hex 32)" > .env

# Run with Docker
docker compose up -d

# Check health
curl http://localhost:3000/health

手动

# Install dependencies
npm install

# Build
npm run build

# Start server
npm start

GitHub Actions

name: Brand Check
on: [pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Validate copy
        run: |
          npx stylemcp validate src/copy/*.json \
            --min-score 80 \
            --format github

环境变量

变量	描述	默认值
PORT	服务端口	3000
STYLEMCP_API_KEY	用于身份验证的 API 密钥	（无）
GITHUB_WEBHOOK_SECRET	GitHub Webhook 密钥	（无）

MCP 工具

作为 MCP 服务使用时，StyleMCP 会提供以下工具：

工具	描述
validate_text	根据品牌规则验证文本
rewrite_to_style	改写文本，使其符合品牌语调
get_voice_rules	获取语调与风格指南
get_copy_patterns	获取获批的文案模式
get_cta_rules	获取 CTA 指南
get_tokens	获取设计令牌
list_packs	列出可用的风格包

验证哪些内容？

saas 风格包会检查：

词汇

• 使用简单词语：“use”而非“utilize”，“help”而非“assist”
• 避免行话：“synergy”、“leverage”、“paradigm shift”
• 避免语气较弱的强调词：“very”、“really”、“extremely”

表达模式

• 不使用“click here”（无障碍问题）
• 不使用“we're sorry for any inconvenience”（企业式敷衍道歉）
• 不连续使用两个“please”（听起来显得急切）
• 不以“Sorry”开头（先提出解决方案）

CTA

• 避免使用泛泛的表达：“Submit”、“OK”、“Yes/No”、“Click here”
• 使用具体操作：“Save”、“Create”、“Sign up”、“Export”
• 最多 4 个词

限制

• 每个句子最多 25 个词
• （大多数情况下）不使用感叹号
• 使用第一人称复数（“we”、“our”）
• 使用牛津逗号

许可证

MIT