stylemcp

StyleMCP

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

StyleMCP とは？

StyleMCP は、AI が生成したテキストを検証し、ブランドの語調に合うように書き換えます。次の用途に使用できます。

• REST API - あらゆるアプリケーションのテキストを検証します
• MCP サーバー - Claude やその他の AI エージェントと直接連携します
• 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 パック

• 語彙：「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      # 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 パックでは、次の項目をチェックします。

語彙

• 簡単な単語を使います。「utilize」ではなく「use」、「assist」ではなく「help」
• 専門用語を避けます。「synergy」、「leverage」、「paradigm shift」
• 弱い強調語を避けます。「very」、「really」、「extremely」

パターン

• 「click here」は使いません（アクセシビリティ上の問題）
• 「we're sorry for any inconvenience」は使いません（企業的で、真摯に謝罪していない表現）
• 「please」を2回続けて使いません（必死に聞こえるため）
• 「Sorry」で始めません（解決策を先に示します）

CTA

• 汎用的な表現を避けます。「Submit」、「OK」、「Yes/No」、「Click here」
• 具体的なアクションを使います。「Save」、「Create」、「Sign up」、「Export」
• 最大4語です

制約

• 1文あたり最大25語
• （ほとんどの状況で）感嘆符を使わない
• 一人称複数形（「we」、「our」）
• オックスフォードコンマ

ライセンス

MIT