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 文档