Userology MCP Server

用户学MCP服务器

一 MCP（模型上下文协议） 暴露的服务器 用户体验研究平台 作为任何兼容MCP的AI客户端（Claude Desktop、Cursor、Windsurf等）的工具和资源。

它的作用

该服务器包装了用户研究服务REST API，使人工智能助手能够：

• 创建和管理研究 --起草、启动、复制和配置用户体验研究
• 构建面试指南 --人工智能生成、编辑和改写面试指南
• 管理部门/任务 --添加原型测试、概念测试、语音访谈和现场产品研究部分
• 访问分析 --获取定性见解、定量指标、问答分析和完整的研究报告
• 使用合成工作室 --进行人工智能驱动的对话，探索研究成果
• 查看会话数据 --访问参与者列表、会话记录和录音
• 分析Figma原型 --从Figma文件中提取屏幕上下文

快速开始

1.安装

cd userology-mcp-server
pip install -e .

2.配置

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

所需变量：

3.添加到克劳德桌面

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "userology": {
      "command": "userology-mcp",
      "env": {
        "USEROLOGY_TENANT_ID": "your-tenant-id",
        "USEROLOGY_ID_TOKEN": "your-token"
      }
    }
  }
}

4.使用MCP检查员进行测试

npx @modelcontextprotocol/inspector userology-mcp

可用工具（共45个）

学习管理（9个工具）

create_study · create_study_from_description · get_study · list_studies · update_study_name · update_study_details · update_study_status · copy_study · delete_study

部门/任务管理（7个工具）

create_section · get_sections · get_section · update_section · delete_section · copy_section · reorder_section

面试指南（4个工具）

get_interview_guides · update_interview_guide · generate_guide · rephrase_guide

分析和报告（11个工具）

get_analytics_status · generate_analytics · get_qualitative_insights · get_quantitative_data · get_qna_analysis · get_study_summary · get_study_insights · get_study_report · generate_study_report · get_session_report · get_ui_annotations

合成工作室（6个工具）

create_synthesis_chat · list_synthesis_chats · get_synthesis_chat · send_synthesis_message · delete_synthesis_chat · share_synthesis_chat

会话和参与者数据（7个工具）

get_participants · get_session · get_session_recordings · get_sessions_report · get_participant_sessions_report · get_study_tags · update_study_tags

Figma集成（1个工具）

get_figma_context

资源

建筑

MCP Client (Claude / Cursor / etc.)
       │ MCP Protocol (stdio)
       ▼
userology-mcp-server
       │ HTTPS
       ▼
researcher-service (existing Userology backend)

许可证

麻省理工学院