Signal Relay

🚀 信號中繼 - SocioLogic MCP 服務器

這是一個遠程 MCP（模型上下文協議）服務器，可將 AI 代理連接到 SocioLogic 的合成角色平臺。通過自然對話，你可以對逼真的客戶角色進行訪談、開展多角色研究活動，並導出適合展示的報告。

🚀 快速開始

使用託管服務器（推薦）

最快的啟動方式是使用我們託管在 https://mcp.sociologicai.com 的服務器。

1. 獲取 API 密鑰：訪問 sociologic.ai/dashboard/api-keys（註冊時可獲得 100 個免費積分）。
2. 配置 MCP 客戶端：
   • Claude 桌面版（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 代碼版**（項目中的 `.mcp.json` 文件）：

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

3. 開始聊天！ 讓 Claude 對角色進行訪談、創建活動或探索市場。

✨ 主要特性

• 20 種 MCP 工具：可全面訪問角色、活動、焦點小組、積分和網絡研究。
• 高保真角色：具有一致的人口統計學、心理統計學和行為特徵的合成角色。
• 語義記憶：基於 RAG 的記憶檢索，確保角色在對話中的連續性。
• 邊緣部署：運行在 Cloudflare Workers 上（300 多個地點，延遲小於 50 毫秒）。
• 安全可靠：採用 API 密鑰認證、請求驗證，邊緣不存儲數據。

📦 安裝指南

自行託管

將你自己的實例部署到 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"

🔧 技術細節

架構

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

安全

• API 密鑰：通過 X-API-Key 頭部或 Authorization: Bearer 頭部傳遞。
• 請求大小：限制為 1MB，以防止拒絕服務攻擊。
• 輸入驗證：對所有工具參數使用 Zod 模式進行驗證。
• 數據存儲：邊緣不存儲數據，所有數據都流向 SocioLogic API。

速率限制

對於生產部署，建議啟用 Cloudflare 的速率限制：

1. 訪問 Cloudflare 儀表盤 > 安全 > WAF > 速率限制規則。
2. 創建規則：每個 IP 每 10 秒最多 100 個請求。

📄 定價

免費套餐：註冊時可獲得 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 文檔