Signal Relay

io.github.SocioLogicAI由 GitHub 账号 SocioLogicAI 发布v2.0.0更新于 Nov 2, 2026

Connect AI agents to SocioLogic's synthetic persona platform for market research.

已验证Streamable HTTP可网页运行网页搜索与抓取数据与分析商业与电商

概览

AI 生成的概览

将助手连接到 SocioLogic 的合成人物平台，可访谈 AI 人物、运行研究项目并导出报告。

可以做什么
  • 浏览、查看并创建合成人物，并检索其语义记忆
  • 创建、执行并导出多人物的研究项目，支持 PDF 或 JSON 输出
  • 将人物组织为焦点小组并向其中添加成员
  • 搜索网络并跨多个来源研究主题
  • 查询积分余额与用量
适用场景
适合需要模拟客户人物提供市场调研式反馈，或希望在聊天客户端中运行并导出多人物访谈项目、而不必使用 SocioLogic 后台的场景。
运行要求
需要 SocioLogic 账号与 API 密钥，通过 X-API-Key 请求头（或 Bearer 令牌）传递。推荐使用托管端点；自托管需 Node.js 18+ 与 Cloudflare 账号。各项操作会消耗积分。
安装前请注意
操作会消耗积分：列出与获取各 1 点，创建人物 5-50 点，访谈每条消息 1 点，项目执行按规模计，免费额度之外可能产生费用。API 密钥为机密，经请求头传递。创建人物、项目与焦点小组会向你的 SocioLogic 账号写入数据，请求会转发至 SocioLogic API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Signal Relay，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.SocioLogicAI%2Fsignal-relay/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "signal-relay": {
      "type": "http",
      "url": "https://mcp.sociologic.ai/"
    }
  }
}

README

Signal Relay - SocioLogic MCP Server

[License: MIT] [MCP]

A remote MCP (Model Context Protocol) server that connects AI agents to SocioLogic's synthetic persona platform. Interview realistic customer personas, run multi-persona research campaigns, and export board-ready reports—all through natural conversation.

Features

  • 24 MCP Tools - Personas, campaigns, focus groups, web research, RNG, credits, and payments
  • High-Fidelity Personas - Synthetic personas with consistent demographics, psychographics, and behavior
  • Semantic Memory - RAG-powered memory retrieval for persona continuity across conversations
  • Edge Deployed - Runs on Cloudflare Workers (300+ locations, <50ms latency)
  • Secure - API key authentication, request validation, no data stored on edge

Quick Start

Use the Hosted Server (Recommended)

The fastest way to get started is using our hosted server at https://mcp.sociologic.ai.

  1. Get an API key at sociologic.ai/dashboard/api-keys (100 free credits on signup)

  2. Configure your MCP client:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Claude Code (.mcp.json in your project):

json
{  "mcpServers": {    "sociologic": {      "transport": "http",      "url": "https://mcp.sociologic.ai",      "headers": {        "X-API-Key": "YOUR_API_KEY"      }    }  }}
  1. Start chatting! Ask Claude to interview personas, create campaigns, or explore the marketplace.

Self-Hosting

Deploy your own instance to Cloudflare Workers:

Prerequisites

Installation

bash
# Clone the repositorygit clone https://github.com/SocioLogicAI/signal-relay.gitcd signal-relay
# Install dependenciesnpm install
# Login to Cloudflarenpx wrangler login
# Deploynpx wrangler deploy

Your server will be available at https://sociologic-mcp-server.<your-subdomain>.workers.dev

Local Development

bash
npm run dev

Starts a local server at http://localhost:8787.

Available Tools

ToolDescription
sociologic_list_personasList synthetic personas from marketplace or private collection
sociologic_get_personaGet detailed persona information (demographics, psychographics, traits)
sociologic_create_personaGenerate a new persona from natural language description
sociologic_get_persona_memoriesRetrieve persona's semantic memories via vector search
sociologic_list_campaignsList research campaigns with status and results
sociologic_get_campaignGet campaign details including interviews and findings
sociologic_create_campaignCreate multi-persona research campaign with custom questions
sociologic_execute_campaignExecute draft campaign (async background processing)
sociologic_export_campaignExport campaign results as PDF or JSON
sociologic_list_focus_groupsList focus groups for cohort-based research
sociologic_get_focus_groupGet focus group details with member personas
sociologic_create_focus_groupCreate new focus group to organize personas
sociologic_add_personas_to_focus_groupAdd personas to an existing focus group
sociologic_get_credits_balanceCheck current credits balance and usage
sociologic_search_webSearch the web and scrape results
sociologic_research_topicResearch a topic with multiple sources

API Endpoints

EndpointMethodDescription
/POSTJSON-RPC 2.0 endpoint for MCP protocol
/healthGETHealth check (requires API key)
/infoGETServer information and available tools

Example Usage

List Available Personas

bash
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      }    }  }'

Configuration

Environment Variables

VariableDescriptionDefault
SOCIOLOGIC_API_URLBackend API URLhttps://www.sociologic.ai

wrangler.toml

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

Security

  • API keys are passed via X-API-Key header or Authorization: Bearer header
  • Request size limited to 1MB to prevent DoS
  • Input validation via Zod schemas on all tool parameters
  • No data stored on edge - all data flows through to the SocioLogic API

Rate Limiting

For production deployments, we recommend enabling Cloudflare's rate limiting:

  1. Go to Cloudflare Dashboard > Security > WAF > Rate limiting rules
  2. Create a rule: 100 requests per 10 seconds per IP

Architecture

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

Pricing

OperationCredits
List personas1
Get persona1
Create persona5-50 (by fidelity tier)
Interview persona1 per message
Campaign executionVaries by size

Free tier: 100 credits on signup. See sociologic.ai/pricing for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links

来源：README.md，提交 2f21229

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v2.0.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分