signal-relay

Signal Relay - SocioLogic MCP Server

一个远程 MCP（Model Context Protocol）服务，可将 AI Agent 连接到 SocioLogic 的合成人格平台。通过自然对话访谈逼真的客户人格、开展多人格研究活动，并导出可直接用于董事会的报告。

功能

• 24 个 MCP 工具 - 人格、活动、焦点小组、网络研究、RNG、积分和付款
• 高保真人格 - 拥有一致人口统计特征、心理特征和行为模式的合成人格
• 语义记忆 - 由 RAG 驱动的记忆检索，确保人格在多轮对话中的连贯性
• 边缘部署 - 在 Cloudflare Workers 上运行（300 多个位置，延迟低于 50 毫秒）
• 安全 - API 密钥身份验证、请求验证，边缘端不存储数据

快速开始

使用托管服务（推荐）

最快的入门方式是使用我们托管在 https://mcp.sociologic.ai 的服务。

1. 获取 API 密钥，前往 sociologic.ai/dashboard/api-keys（注册即赠 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 标头传递
• 请求大小限制为 1MB，以防止 DoS
• 输入验证：使用 Zod 架构验证所有工具参数
• 不存储数据：边缘端不存储任何数据；所有数据都会转发至 SocioLogic API

速率限制

对于生产部署，我们建议启用 Cloudflare 的速率限制：

1. 前往 Cloudflare 控制面板 > 安全性 > WAF > 速率限制规则
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。

贡献

欢迎贡献！欢迎提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

链接

• SocioLogic 网站
• API 文档
• MCP 协议规范
• Cloudflare Workers 文档