信号中继-SocioLogic MCP服务器
 
将AI代理连接到的远程MCP(模型上下文协议)服务器 社会逻辑 合成人物角色平台。通过自然对话,采访真实的客户角色,开展多角色研究活动,并导出董事会准备的报告。
特性
- 20个MCP工具 -完全访问人物角色、活动、焦点小组、学分和网络研究
- 高保真人物 -具有一致人口统计、心理图形和行为的合成人物角色
- 语义记忆 -基于RAG的记忆检索,实现对话中的角色连续性
- 已部署边缘 -在Cloudflare Workers上运行(300多个位置,\.workers.dev`
本地开发
npm run dev在以下位置启动本地服务器 http://localhost:8787.
可用工具
| 工具 | 说明 |
|---|---|
sociologic_list_personas | 列出来自市场或私人收藏的合成人物角色 |
sociologic_get_persona | 获取详细的人物信息(人口统计、心理图、特征) |
sociologic_create_persona | 从自然语言描述生成新角色 |
sociologic_interview_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_scrape_url | 从URL中抓取内容(网络研究) |
sociologic_search_web | 搜索网络并抓取结果 |
sociologic_research_topic | 研究一个有多个来源的主题 |
sociologic_get_company_info | 从网站获取公司信息 |
API终点
| 端点 | 方法 | 描述 |
|---|---|---|
/ | POST | MCP协议的JSON-RPC 2.0端点 |
/health | GET | 运行状况检查(需要API密钥) |
/info | GET | 服务器信息和可用工具 |
示例用法
采访人物
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
}
}
}'配置
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
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许可证获得许可-请参阅 许可证 文件以获取详细信息。
