Stylemcp

🚀 StyleMCP

AIモデルとエージェントに対する実行可能なブランドルールです。AIによって生成されたすべてのメッセージをブランドに沿ったものに保ちます。

🚀 クイックスタート

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

# インストール
npm install -g stylemcp

# テキストの検証
stylemcp validate "Click here to learn more"

# ファイルの検証
stylemcp validate src/copy/homepage.json --pack saas

# テキストの書き換え
stylemcp rewrite "Please utilize our product" --mode aggressive

MCP (Claude Desktop)

claude_desktop_config.jsonに追加します:

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

これでClaudeはブランドルールを使用してテキストを検証および書き換えることができます。

✨ 主な機能

StyleMCPはAIによって生成されたテキストを検証し、ブランドのボイスに合うように書き換えます。以下のように使用できます:

• REST API - 任意のアプリケーションからのテキストを検証
• MCP Server - Claudeや他のAIエージェントとの直接統合
• CLI - ターミナルまたはCI/CDでコピーをチェック
• GitHub Action - プルリクエストでブランドに沿わないコピーを検出

📦 インストール

Docker

# リポジトリをクローン
git clone https://github.com/3DUNLMTD/stylemcp.git
cd stylemcp

# 環境をセットアップ
echo "STYLEMCP_API_KEY=$(openssl rand -hex 32)" > .env

# Dockerで実行
docker compose up -d

# ヘルスチェック
curl http://localhost:3000/health

手動

# 依存関係をインストール
npm install

# ビルド
npm run build

# サーバーを起動
npm start

💻 使用例

基本的な使用法

# APIを使用したテキスト検証
curl -X POST https://stylemcp.com/api/validate \
  -H "Content-Type: application/json" \
  -d '{"text": "Click here to learn more!"}'

高度な使用法

# 独自のパックを使用したAPI呼び出し
curl -X POST https://stylemcp.com/api/validate \
  -d '{"text": "Your text", "pack": "my-brand"}'

📚 ドキュメント

APIエンドポイント

スタイルパック

StyleMCPはスタイルパック（ブランドルールを定義するYAMLファイル）を使用します。

利用可能なパック

例: saasパック

• 語彙: "utilize"よりも "use"、"assist"よりも "help" を使用する
• 禁止語: "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      # パックのメタデータ
    voice.yaml         # トーン、語彙、禁止語
    copy_patterns.yaml # 再利用可能なコピーテンプレート
    cta_rules.yaml     # ボタン/CTAガイドライン
    tokens.json        # デザイントークン (オプション)

独自のパックを作成

# デフォルトのパックをコピー
cp -r packs/saas packs/my-brand

# ルールを編集
nano packs/my-brand/voice.yaml

# 独自のパックを使用
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

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

環境変数

MCPツール

MCPサーバーとして使用する場合、StyleMCPは以下のツールを提供します:

検証される内容

saasパックは以下の項目をチェックします:

語彙

• シンプルな単語を使用: "use" を "utilize" ではなく、"help" を "assist" ではなく使用する
• 専門用語を避ける: "synergy", "leverage", "paradigm shift"
• 弱い強調表現を避ける: "very", "really", "extremely"

パターン

• "click here" を使用しない (アクセシビリティの問題)
• "we're sorry for any inconvenience" を使用しない (企業的な謝罪ではない)
• 二重の "please" を使用しない (切望的に聞こえる)
• "Sorry" で始めない (解決策を先に提示する)

CTAs

• 汎用的なものを避ける: "Submit", "OK", "Yes/No", "Click here"
• 具体的なアクションを使用: "Save", "Create", "Sign up", "Export"
• 最大4語

制約

• 文ごとに最大25語
• ほとんどのコンテキストで感嘆符を使用しない
• 一人称複数形 ("we", "our")
• オックスフォードカンマ

📄 ライセンス

MIT