satorify-mcp/README.md

MCP Server for Satori Syntax Generation (140-character X posts)

# Satori Syntax MCP Server

Claude Code用のさとり構文生成MCPサーバーです。140文字のX投稿用さとり構文を効率的に生成できます。

## 機能

### 🔧 提供ツール

1. **generate_satori_syntax** - さとり構文を生成（140文字のX投稿用）
2. **get_satori_structure_types** - さとり構文の構文タイプ一覧を取得

### 📝 さとり構文タイプ

- **A**: 基本形 - 万能でどんな状況にも適応可能な構文
- **B**: 常識の否定 - 常識や既成概念を覆すことで読者の関心を引きつける
- **C**: 一般的なニュース - ニュースを軸にしつつ、読者の興味を引く構文
- **D**: 衝撃的なニュース - 驚きや感動を伴う内容で感情を動かす
- **E**: ステップ紹介 - 具体的な手順を示して行動を促す構文

## インストール・設定

### 1. プロジェクトのビルド

```bash
git clone <repository-url>
cd satorify-mcp
npm install
npm run build
```

### 2. Claude Codeでの設定

Claude Codeの設定ファイル（通常 `~/.config/claude-code/claude_desktop_config.json`）に以下を追加：

```json
{
  "mcpServers": {
    "satori-syntax": {
      "command": "node",
      "args": ["/path/to/satorify-mcp/dist/index.js"]
    }
  }
}
```

### 3. Claude Codeの再起動

設定ファイルを更新後、Claude Codeを再起動してください。

## 使用方法

### さとり構文生成

```typescript
// 基本形（構文A）でさとり構文生成
await generate_satori_syntax({
  structure_type: "A",
  target_audience: "ADHDタイプの人",
  message_content: "Geminiを活用すると仕事が効率化する",
  expected_action: "Geminiを試してみる"
});

// 常識の否定（構文B）でさとり構文生成
await generate_satori_syntax({
  structure_type: "B",
  target_audience: "AIを使いこなしたい人",
  message_content: "ChatGPTだけでなく、他のAIツールを活用すべき",
  expected_action: "適材適所でAIを使い分ける"
});

// ニュース系（構文C）でさとり構文生成
await generate_satori_syntax({
  structure_type: "C",
  target_audience: "会社でAIを使いたいけど課金に悩んでいる人",
  message_content: "AIツールを試す",
  expected_action: "AIツールを試す",
  news_content: "最新AIツールの無料公開"
});

// 衝撃的なニュース（構文D）でさとり構文生成
await generate_satori_syntax({
  structure_type: "D",
  target_audience: "最新技術に興味がある人",
  message_content: "AIがリアルタイムアバターを実現",
  expected_action: "動画を見て技術を体験する",
  news_content: "AIがリアルタイムアバターを実現"
});

// ステップ紹介（構文E）でさとり構文生成
await generate_satori_syntax({
  structure_type: "E",
  target_audience: "副業で安定収入を目指す人",
  message_content: "AIを活用して副業収入を得る手順",
  expected_action: "手順を実行し、副業収入を得る"
});
```

### さとり構文タイプ取得

```typescript
await get_satori_structure_types();
```

## ツール詳細

### generate_satori_syntax

**パラメータ:**
- `structure_type` (必須): 構文タイプ（A/B/C/D/E）
- `target_audience` (必須): ターゲット層
- `message_content` (必須): 伝えたいメッセージの内容
- `expected_action` (必須): 期待する行動
- `news_content` (オプション): ニュース内容（構文CとDで使用）

### get_satori_structure_types

**パラメータ:** なし

## 開発

### 開発環境のセットアップ

```bash
npm install
npm run dev  # ウォッチモードでの開発
```

### テスト実行

```bash
npm test
```

### ディレクトリ構造

```
src/
├── index.ts              # MCPサーバーのメインファイル
├── types.ts              # 型定義
└── satori-templates.ts   # さとり構文テンプレート
```

## 貢献

プルリクエストやイシューの報告を歓迎します。

## ライセンス

MIT License

## 注意事項

- このツールはさとり構文のプロンプトを生成します。実際の構文生成にはLLMが必要です。
- さとり構文生成は、使用しているLLM（Claude、ChatGPT、Geminiなど）で実行してください。
- さとり構文の使用には十分注意し、適切なターゲットと内容で使用してください。
- X（Twitter）の利用規約に従って使用してください。
- 生成されたコンテンツの品質や適切性についてご自身で確認してください。

## サポート

問題が発生した場合は、GitHubのイシューで報告してください。