Signal Relay

🚀 Signal Relay - SocioLogic MCP Server

Signal Relayは、AIエージェントをSocioLogicの合成ペルソナプラットフォームに接続するリモートMCP（Model Context Protocol）サーバーです。リアルな顧客ペルソナとのインタビュー、複数ペルソナの調査キャンペーンの実行、および会議用のレポートのエクスポートを、自然な会話を通じて行うことができます。

✨ 主な機能

• 20のMCPツール - ペルソナ、キャンペーン、フォーカスグループ、クレジット、およびウェブリサーチへの完全なアクセス
• 高忠実度のペルソナ - 一貫した人口統計学的、心理統計学的、および行動特性を持つ合成ペルソナ
• セマンティックメモリ - 会話全体でペルソナの連続性を保つためのRAGベースのメモリ検索
• エッジデプロイ - Cloudflare Workers上で実行（300以上の場所、50ms未満のレイテンシ）
• セキュア - APIキー認証、リクエスト検証、エッジでのデータ保存なし

🚀 クイックスタート

ホステッドサーバーを使用する（推奨）

最も迅速に始める方法は、https://mcp.sociologicai.comのホステッドサーバーを使用することです。

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.sociologicai.com",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

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

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

3. チャットを開始しましょう！Claudeにペルソナのインタビュー、キャンペーンの作成、またはマーケットプレイスの探索を依頼してください。

📦 インストール

自前でCloudflare Workersにインスタンスをデプロイすることもできます。

前提条件

• Node.js v18以上
• Cloudflareアカウント（無料プランで利用可能）

インストール手順

# リポジトリをクローンする
git clone https://github.com/SocioLogicAI/signal-relay.git
cd signal-relay

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

# Cloudflareにログインする
npx wrangler login

# デプロイする
npx wrangler deploy

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

ローカル開発

npm run dev

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

💻 使用例

ペルソナのインタビュー

curl -X POST https://mcp.sociologicai.com/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "sociologic_interview_persona",
      "arguments": {
        "slug": "enterprise-buyer",
        "message": "What would make you hesitant to try a new AI product?"
      }
    }
  }'

利用可能なペルソナのリスト表示

curl -X POST https://mcp.sociologicai.com/ \
  -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
      }
    }
  }'

📚 詳細ドキュメント

利用可能なツール

APIエンドポイント

設定

環境変数

wrangler.toml

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

セキュリティ

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

レート制限

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

1. Cloudflareダッシュボード > セキュリティ > WAF > レート制限ルールにアクセスします。
2. ルールを作成します：10秒あたり100リクエスト/IP。

アーキテクチャ

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

価格

無料プラン：登録時に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ドキュメント