使用说明
信号中继-SocioLogic MCP服务器
将AI代理连接到的远程MCP（模型上下文协议）服务器 社会逻辑 合成人物角色平台。通过自然对话，采访真实的客户角色，开展多角色研究活动，并导出董事会准备的报告。
特性
- 24个MCP工具 -人物角色、活动、焦点小组、网络研究、RNG、信用和支付
- 高保真人物 -具有一致人口统计、心理图形和行为的合成人物角色
- 语义记忆 -基于RAG的记忆检索，实现对话中的角色连续性
- 已部署边缘 -在Cloudflare Workers上运行（300多个位置，<50ms延迟）
- 安全 -API密钥验证，请求验证，边缘上未存储任何数据
快速开始
使用托管服务器（推荐）
最快的入门方法是使用我们的托管服务器 https://mcp.sociologic.ai.
-
获取API密钥 在 社会学.ai/dashboard/api-keys （注册时可获得100个免费积分）
-
配置您的MCP客户端：
克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"sociologic": {
"transport": "http",
"url": "https://mcp.sociologic.ai",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
克劳德代码 (.mcp.json 在您的项目中）：
{
"mcpServers": {
"sociologic": {
"transport": "http",
"url": "https://mcp.sociologic.ai",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
- 开始聊天！ 让克劳德采访人物角色、创建活动或探索市场。
自我寄宿
将您自己的实例部署到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 |
牧马人.汤姆
[vars]
SOCIOLOGIC_API_URL = "https://www.sociologic.ai"
安全
- API密钥 通过
X-API-Key标题或Authorization: Bearer头球 - 请求大小 限制为1MB以防止DoS
- 输入验证 通过所有工具参数上的Zod模式
- 未存储数据 边缘-所有数据流到SocioLogic API
速率限制
对于生产部署，我们建议启用Cloudflare的速率限制：
- 转到Cloudflare仪表板>安全>WAF>速率限制规则
- 创建规则：每个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学分。看 社会学/定价 了解详情。
贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
