signal-relay

Signal Relay - SocioLogic MCP Server

AI エージェントを SocioLogic の 合成ペルソナプラットフォームに接続するリモート MCP（Model Context Protocol）サーバーです。リアルな顧客ペルソナにインタビューし、複数のペルソナを対象にした調査キャンペーンを実施して、取締役会向けレポートをエクスポートできます。すべて自然な会話で行えます。

特長

• 24 個の MCP ツール - ペルソナ、キャンペーン、フォーカスグループ、ウェブ調査、RNG、クレジット、支払いに対応
• 高精度なペルソナ - 一貫した人口統計、心理特性、行動特性を備えた合成ペルソナ
• セマンティックメモリ - RAG を活用したメモリ検索により、会話をまたいだペルソナの一貫性を維持
• エッジにデプロイ - Cloudflare Workers 上で動作（300 以上の拠点、レイテンシ <50ms）
• 安全 - API キー認証、リクエスト検証、エッジ上にデータを保存しません

クイックスタート

ホスト型サーバーを使う（推奨）

すぐに始めるには、https://mcp.sociologic.ai でホストされているサーバーを使うのが最も簡単です。

1. sociologic.ai/dashboard/api-keys で API キーを取得します（サインアップ時に 100 クレジットが無料で付与されます）。

2. MCP クライアントを設定します。

Claude Desktop（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "sociologic": {
      "transport": "http",
      "url": "https://mcp.sociologic.ai",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code（プロジェクト内の .mcp.json）：

{
  "mcpServers": {
    "sociologic": {
      "transport": "http",
      "url": "https://mcp.sociologic.ai",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

3. チャットを始めましょう！ Claude にペルソナへのインタビューやキャンペーンの作成、マーケットプレイスの探索を依頼できます。

セルフホスティング

独自のインスタンスを Cloudflare Workers にデプロイします。

前提条件

• Node.js v18+
• Cloudflare アカウント（無料プランで利用できます）

インストール

# Clone the repository
git clone https://github.com/SocioLogicAI/signal-relay.git
cd signal-relay

# Install dependencies
npm install

# Login to Cloudflare
npx wrangler login

# Deploy
npx wrangler deploy

サーバーは https://sociologic-mcp-server.<your-subdomain>.workers.dev で利用できます。

ローカル開発

npm run dev

http://localhost:8787 でローカルサーバーを起動します。

利用可能なツール

ツール	説明
sociologic_list_personas	マーケットプレイスまたはプライベートコレクションの合成ペルソナを一覧表示
sociologic_get_persona	ペルソナの詳細情報（人口統計、心理特性、特性）を取得
sociologic_create_persona	自然言語による説明から新しいペルソナを生成
sociologic_get_persona_memories	ベクトル検索でペルソナのセマンティックメモリを取得
sociologic_list_campaigns	ステータスと結果を含む調査キャンペーンを一覧表示
sociologic_get_campaign	インタビューと調査結果を含むキャンペーンの詳細を取得
sociologic_create_campaign	独自の質問を設定して複数のペルソナを対象とする調査キャンペーンを作成
sociologic_execute_campaign	下書きキャンペーンを実行（非同期のバックグラウンド処理）
sociologic_export_campaign	キャンペーンの結果を PDF または JSON としてエクスポート
sociologic_list_focus_groups	コホートベースの調査向けにフォーカスグループを一覧表示
sociologic_get_focus_group	メンバーのペルソナを含むフォーカスグループの詳細を取得
sociologic_create_focus_group	ペルソナを整理するための新しいフォーカスグループを作成
sociologic_add_personas_to_focus_group	既存のフォーカスグループにペルソナを追加
sociologic_get_credits_balance	現在のクレジット残高と使用状況を確認
sociologic_search_web	ウェブを検索して結果を取得
sociologic_research_topic	複数の情報源を使ってトピックを調査

API エンドポイント

エンドポイント	メソッド	説明
/	POST	MCP プロトコル向け JSON-RPC 2.0 エンドポイント
/health	GET	ヘルスチェック（API キーが必要）
/info	GET	サーバー情報と利用可能なツール

使用例

利用可能なペルソナを一覧表示

curl -X POST https://mcp.sociologic.ai/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "sociologic_list_personas",
      "arguments": {
        "visibility": "public",
        "per_page": 10
      }
    }
  }'

設定

環境変数

変数	説明	デフォルト
SOCIOLOGIC_API_URL	バックエンド API URL	https://www.sociologic.ai

wrangler.toml

[vars]
SOCIOLOGIC_API_URL = "https://www.sociologic.ai"

セキュリティ

• API キーはX-API-KeyヘッダーまたはAuthorization: Bearerヘッダーで渡されます
• リクエストサイズは、DoS を防ぐため1MB に制限されています
• 入力検証は、すべてのツールパラメーターに対して Zod スキーマで行います
• データは保存されません。エッジ上のすべてのデータは SocioLogic API に中継されます

レート制限

本番環境へのデプロイでは、Cloudflare のレート制限を有効にすることをおすすめします。

1. Cloudflare Dashboard > Security > WAF > Rate limiting rules に移動します
2. ルールを作成します：IP ごとに10秒あたり100リクエスト

アーキテクチャ

┌─────────────────┐      ┌─────────────────────┐      ┌─────────────────┐
│                 │      │                     │      │                 │
│   MCP Client    │─────▶│  Cloudflare Worker  │─────▶│  SocioLogic API │
│  (Claude, etc)  │      │   (This Server)     │      │                 │
│                 │◀─────│                     │◀─────│                 │
└─────────────────┘      └─────────────────────┘      └─────────────────┘
        │                         │                          │
        │    MCP Protocol         │    REST API              │
        │    (JSON-RPC 2.0)       │    (HTTPS)               │
        └─────────────────────────┴──────────────────────────┘

料金

操作	クレジット
ペルソナ一覧の取得	1
ペルソナの取得	1
ペルソナの作成	5-50（忠実度ティアによる）
ペルソナへのインタビュー	メッセージごとに1
キャンペーンの実行	規模によって異なります

**無料プラン：**サインアップ時に100クレジットが付与されます。詳細は sociologic.ai/pricingをご覧ください。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細はLICENSEファイルをご覧ください。

リンク

• SocioLogic のウェブサイト
• API ドキュメント
• MCP プロトコル仕様
• Cloudflare Workers のドキュメント